Skip to content

Create a space

POST
/api/v1/spaces
curl --request POST \
--url https://example.com/api/v1/spaces \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "emoji": "example", "name": "example", "position": 1 }'
Media typeapplication/json
object
emoji
string | null
name
string | null
position
integer | null format: int32

Example generated

{
"emoji": "example",
"name": "example",
"position": 1
}

Space created

Media typeapplication/json
object
access_level
required
string
Allowed values: owner read_only owner_edit full_access
created_at
required
string format: date-time
emoji
string | null
id
required
string format: uuid
name
required
string
owner_id
required
string format: uuid
position
integer | null format: int32
updated_at
required
string format: date-time
wins_count
required
integer format: int32

Example

{
"access_level": "owner"
}

Authentication required

Media typeapplication/json
object
error
required
string

Example generated

{
"error": "example"
}

Plan limit reached

Media typeapplication/json
object
error
required
string
upgrade_url
required
string format: uri

Example generated

{
"error": "example",
"upgrade_url": "https://example.com"
}

Validation failed

Media typeapplication/json
object
error
required
string

Example generated

{
"error": "example"
}