v1

latestOpenAPI 3.1.0Any Source Available License 1.02026-07-1736102200.0 KB
Spaces

Create space

Creates a new space based on a supplied name and description in the JSON request body. The endpoint is subject to rate limiting and automatically applies default configurations such as generating a random icon and initializing the workspace with default settings (for example, a default dashboard or home page). On success, the new space’s full metadata is returned, enabling the client to immediately switch context to the new internal.

post/v1/spaces

Headers

Anytype-Versionstring required

The version of the API to use

Request body

descriptionstring

The description of the space

namestring required

The name of the space

Example request

{
  "description": "The local-first wiki",
  "name": "New Space"
}

Response

The created space

Example response

{
  "space": {
    "description": "The local-first wiki",
    "gateway_url": "http://127.0.0.1:31006",
    "icon": {
      "emoji": "📄"
    },
    "id": "bafyreigyfkt6rbv24sbv5aq2hko3bhmv5xxlf22b4bypdu6j7hnphm3psq.23me69r569oi1",
    "name": "My Space",
    "network_id": "N83gJpVd9MuNRZAuJLZ7LiMntTThhPc6DtzWWVjb1M3PouVU",
    "object": "space"
  }
}