This endpoint allows you to manage teams in organizations.

Request Headers

Content-Type: application/json
Accept: application/json
Authorization: Bearer access_token
Host: example.org
Cookie: 

Request Example

curl "http://shares.example.com/organizations/32400255/teams" -d '{"name":"API Create team"}' -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer access_token" \
-H "Host: example.org" \
-H "Cookie: "

Request Parameters (POST and PUT)

Name Required/Optional Type Description
name Required string Name of team

Success Response Codes

Method Code
GET 200 OK
POST 201 Created
PUT 200 OK
DELETE 204 No Content

Error Response Codes

Description of error is included in response body.

Method Error Reason
POST 422 Unprocessable Entity Submitted a parameter with an invalid or empty value
PUT 422 Unprocessable Entity Submitted a parameter with an invalid or empty value

Response Attributes

Name Type Description
id integer ID of team
name string Name of team

List an organization's teams

GET /organizations/{organization_id}/teams

Request Example

curl -g "http://shares.example.com/organizations/32400255/teams" -X GET

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
ETag: W/"0a9557ad0cea33f765e1fb3bc44a39ab"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 567712c7-7e29-48d7-8f7b-832290d161db
X-Runtime: 0.022002
Content-Length: 30

Success Response Example

200 OK
[
{
"id": 81831458,
"name": "Pro"
}
]


Create new team in organization

POST /organizations/{organization_id}/teams

Request Example

curl "http://shares.example.com/organizations/32400255/teams" -d '{"name":"API Create team"}' -X POST

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
ETag: W/"3c28ece9afadd4655fcfc2b1a95ac665"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 997ac6bf-dbc5-49c4-9ac2-f0b151169f1f
X-Runtime: 0.025780
Content-Length: 40

Success Response Example

201 Created
{
  "id": 81831460,
  "name": "API Create team"
}

Error Response Example

422 Unprocessable Entity
{
          "errors": {
            "name": [
              "can't be blank"
            ]
          }
        }


Update team in organization

PUT /organizations/{organization_id}/teams/{id}

Request Example

curl "http://shares.example.com/organizations/32400255/teams/81831458" -d '{"name":"New name"}' -X PUT

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
ETag: W/"b13a363204fdb52414f63c6f1c55b19c"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: f2ad3a23-695b-4a2f-8d2f-ca1cbdfe10d1
X-Runtime: 0.024449
Content-Length: 33

Success Response Example

200 OK
{
  "id": 81831458,
  "name": "New name"
}

Error Response Example

422 Unprocessable Entity
{
              "errors": {
                "name": [
                  "can't be blank"
                ]
              }
              }


Remove a team from organization

DELETE /organizations/{organization_id}/teams/{id}

Request Example

curl "http://shares.example.com/organizations/32400255/teams/81831458" -d '' -X DELETE

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Cache-Control: no-cache
X-Request-Id: e4e529c4-01ec-49c1-9fca-63c1cea5ef1c
X-Runtime: 0.031918

Success Response Example

204 No Content

Video player

Video

×