List Teams via API
This method allows you to list all teams in your DeployHQ account.
Tip: You can explore and test this endpoint interactively using our OpenAPI documentation.
URL
/teams
HTTP Method
GET
Supported Parameters
This endpoint does not accept any parameters.
Example cURL Request
curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
https://test.deployhq.com/teams
Example Response
[
{
"identifier": "abc123-def456",
"name": "Engineering",
"is_admin": false,
"can_manage_users": false,
"can_manage_billing": false,
"can_manage_agents": false,
"can_create_projects": true,
"all_projects_allowed": true,
"members": [
{
"id": 12345,
"identifier": "9e11def8-8c43-454e-8c99-3c5b9cf08396",
"first_name": "John",
"last_name": "Doe",
"email_address": "john@example.com"
}
],
"project_assignments": []
}
]
Notes
- Returns an array of all teams in the account
- Each team includes its members and project assignments