Spaces

Create a space

post/spaces

Request

Base URL: https://next-api.saturation.io/v1
URL: https://next-api.saturation.io/v1/spaces
Auth: HTTP bearer

Headers

Idempotency-Keystring required

Unique request key, 16 to 255 characters. Retrying the same request returns the first response. Missing or invalid keys return 400 validation; reuse with a different body returns 409 idempotency_conflict.

Request body

namestring required

slugstring

Unique space handle. Generated from name when omitted.

imagestring nullable

parentIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

Example request

{
  "name": "Features",
  "parentId": "txn_8f2a1c9e"
}

Response

The created space.

idstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

slugstring required

The space's human handle (unique per workspace).

namestring required

imagestring nullable

parentIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

archivedboolean required

Whether the space is archived.

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "id": "txn_8f2a1c9e",
  "slug": "features",
  "name": "Features",
  "parentId": "txn_8f2a1c9e"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.