apiary.apib

FORMAT: 1A
HOST: http://localhost

# example api
Is example api

# Group Users
Users related resources of the **Users API**

## Users Collection [/users]

### Create a User [POST]
+ Request (application/json; charset=utf-8)

        {
            "label": "Mario"
        }

+ Response 201 (application/json; charset=utf-8)

    + Schema

            {
                "$schema": "http://json-schema.org/draft-03/schema#",
                "type": "object",
                "required": true,
                "properties": {
                    "_id": {
                        "type": "string",
                        "required": true
                    },
                    "label": {
                        "type": "string",
                        "required": true
                    }
                }
            }

## User [/users/{id}]
A single User object with all its details

+ Parameters
    + id (required, string, `53c4f8314d84769d9f61ec87`) ... ObjectID `id` of the User to perform action with. Has example value.

### Remove a User [DELETE]
+ Response 204