Teams¶
GET List of Teams¶
Provides a json list of teams and the projects the team is assigned to.
GET /api/v1/teams
Example¶
curl -X GET https://api.ona.io/api/v1/teams
Optional params:
org
: Filter by organization.
Example¶
curl -X GET https://api.ona.io/api/v1/teams?org=bruize
Response¶
[
{
"url": "https://api.ona.io/api/v1/teams/1",
"name": "Owners",
"organization": "bruize",
"projects": []
},
{
"url": "https://api.ona.io/api/v1/teams/2",
"name": "demo team",
"organization": "bruize",
"projects": []
}
]
GET Team Info for a specific team.¶
Shows teams details and the projects the team is assigned to, where:
pk
- unique identifier for the team
GET /api/v1/teams/{pk}
Example¶
curl -X GET https://api.ona.io/api/v1/teams/1
Response¶
{
"url": "https://api.ona.io/api/v1/teams/1",
"name": "Owners",
"organization": "bruize",
"projects": []
}
List members of a team¶
A list of usernames is the response for members of the team.
GET /api/v1/teams/{pk}/members
Example¶
curl -X GET https://api.ona.io/api/v1/teams/1/members
Response¶
["member1"]
Add a user to a team¶
POST {"username": "someusername"}
to /api/v1/teams/<pk>/members
to add a user to the specified team. A list of usernames is the response
for members of the team.
POST /api/v1/teams/{pk}
/members
Response¶
["someusername"]
Set team default permissions on a project¶
POST {"role":"readonly", "project": "project_id"}
to
/api/v1/teams/<pk>/share
to set the default permissions on a project
for all team members.
POST /api/v1/teams/{pk}
/share
Example¶
curl -X POST -d project=3 -d role=readonly https://api.ona.io/api/v1/teams/1/share
Response¶
HTTP 204 NO CONTENT
Remove team default permissions on a project¶
POST {"role":"readonly", "project": "project_id", "remove": "True"}
to /api/v1/teams/<pk>/share
to remove the default permissions on a
project for all team members.
POST /api/v1/teams/{pk}
/share
Example¶
curl -X POST -d project=3 -d role=readonly -d remove=true https://api.ona.io/api/v1/teams/1/share
Response¶
HTTP 204 NO CONTENT