POST /organizations/{name}/teams

This operation creates a new team within a CAVE organization. It requires a unique name, which must be URL-safe.

The operation can only be invoked by an administrator of the organization.

The API also creates a team token named default and attaches it to the team.

The response contains the created team, in JSON format.

Resource URL

https://api.cavellc.io/organizations/{name}/teams

Resource Information

The data must be formatted as JSON, with the following fields:

Field Description Notes
name The name of the team Mandatory

The request must be authenticated with a valid user token, as obtained from a login operation. See POST /users/login for details. The token can be passed as the username (with an empty password) following the Basic Authentication scheme of the HTTP protocol. Alternatively, the same token can be accepted as a Bearer Token, similar to the OAuth2 specification.

Example Request

curl -i -u 8b896055-c295-4a30-a29c-5a97d15f1818: \
     -X POST -H "Content-Type: application/json" \
     -d '{ "name": "runners" }' \
     https://api.cavellc.io/organizations/acme/teams

Example Response

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Location: https://api.cavellc.io/organizations/acme
Content-Length: 246
Connection: keep-alive

{
  "name": "runners",
  "tokens": [
    {
      "id": "79",
      "description": "default",
      "value": "hqocn64ghDoT3nShKtykBJdd60x6oOqPqoNjkwwLbHq6hRRMfhqa4VWk",
      "created": "2014-10-23T16:17:11.209Z"
    }
  ]
}

See Also

Back to Teams

Back to API Main Page