Creates a team.
HTTP
POST /teamsAccess: Session token only. API keys get 403 with insufficient_scope.
Role: Organisation owner or admin.
Request body #
JSON.
| Field | Type | Required | Description |
|---|---|---|---|
name | string | yes | At most 80 characters. |
description | string | no | At most 400 characters. |
icon | string | no | An emoji, at most 16 characters. |
languages | list of string | no | Language codes such as de-de. Lower case, like de or pt-br. |
JSON
{ "name": "Core", "description": "Product translators", "languages": ["de-de", "fr-fr"] }Response 201 #
The team.
JSON
{
"id": "0197a3c5-3c42-7f33-96ea-8a2d4b9f1c53",
"name": "Core",
"icon": "👥",
"accent": null,
"description": "Product translators",
"allProjects": false,
"languages": ["de-de", "fr-fr"],
"members": [
{ "id": "0197a3c2-5b1e-7c4a-9d2f-3e8b6a1f0c55", "name": "Ada Lovelace", "email": "ada@example.com", "initials": "AL", "gradient": "...", "from": "#06b6d4", "to": "#7c3aed", "role": "owner" }
],
"projects": [
{ "projectId": "0197a3c6-4d53-7a44-87fb-9b3e5c0a2d64", "role": "translator" }
]
}Response fields #
| Field | Type | Description |
|---|---|---|
id | string | The id of the team. |
name | string | The name. |
icon | string | An emoji. The app shows an abbreviation of the name instead. |
accent | string or null | A colour. |
description | string | A description. |
allProjects | boolean | Whether the team has access to every project. |
languages | list of string | Language codes the team works in. |
members | list of object | The members: the fields of a person (id, name, email, initials, gradient, from, to) and their team role. |
projects | list of object | The projects the team has access to: projectId and the role the team has there. |
Errors #
| Status | error | When |
|---|---|---|
| 401 | unauthenticated | The token is missing or not valid. |
| 403 | forbidden | You are not an owner or admin. |
| 422 | invalid_request | name is empty or too long, or a language code is not valid. |
| 429 | rate_limited | Too many requests, see Rate limiting. |
See Errors for the error format.