Skip to content

Start my own workspace

POST
/api/me/workspace/
curl --request POST \
--url http://localhost:8000/api/me/workspace/ \
--header 'Authorization: Bearer <token>'

For an account with no team — a client of an academy who is also a coach, or someone who landed on a client invite by mistake: makes the Personal team a coach gets at signup, with its Free plan, and makes it active. 201 when it made one, 200 with the existing team when the account already has one. 404 on deployments without self-signup (local auth).

Media typeapplication/json

POST /api/me/workspace/ — the account’s own team.

object
team_id
required
string format: uuid
created
required

True when this call made the team; false when the account already had one.

boolean

Examples

ExampleAlreadyHadOne

Already had one

{
"team_id": "c0ffee00-0000-4000-8000-000000000001",
"created": false
}
Media typeapplication/json

POST /api/me/workspace/ — the account’s own team.

object
team_id
required
string format: uuid
created
required

True when this call made the team; false when the account already had one.

boolean

Examples

ExampleANewWorkspace

A new workspace

{
"team_id": "c0ffee00-0000-4000-8000-000000000001",
"created": true
}
Media typeapplication/json
object
detail
required

Human-readable message, or a stable machine code for the cases a client branches on. The standard envelope for 400 (validation — a field-keyed object may appear instead), 401 (missing / invalid credentials), 403 (authenticated but not permitted), and 404 (absent — cross-team records are collapsed to 404 so the API never leaks the existence of another team’s data).

string

Example generated

{
"detail": "example"
}
Media typeapplication/json
object
detail
required

Human-readable message, or a stable machine code for the cases a client branches on. The standard envelope for 400 (validation — a field-keyed object may appear instead), 401 (missing / invalid credentials), 403 (authenticated but not permitted), and 404 (absent — cross-team records are collapsed to 404 so the API never leaks the existence of another team’s data).

string

Example generated

{
"detail": "example"
}
Media typeapplication/json
object
detail
required

Human-readable message, or a stable machine code for the cases a client branches on. The standard envelope for 400 (validation — a field-keyed object may appear instead), 401 (missing / invalid credentials), 403 (authenticated but not permitted), and 404 (absent — cross-team records are collapsed to 404 so the API never leaks the existence of another team’s data).

string

Example generated

{
"detail": "example"
}