Capacities

Capacities Space API

Space related operations

GitHub OpenAPI

Operations 2

GET /space Get space #
GET /space/structures Get space structures #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/capacities-io/openapi/capacities-io-space-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/capacities-io/json-schema/capacities-io-api-block-schema.json
📊
JSONSchema
https://artifacts.apis.io/capacities-io/json-schema/capacities-io-writable-api-block-schema.json
📊
JSONSchema
https://artifacts.apis.io/capacities-io/json-schema/capacities-io-api-icon-output-schema.json
📊
JSONSchema
https://artifacts.apis.io/capacities-io/json-schema/capacities-io-append-blocks-position-schema.json
📊
JSONSchema
https://artifacts.apis.io/capacities-io/json-schema/capacities-io-api-label-option-output-schema.json
📊
JSONSchema
https://artifacts.apis.io/capacities-io/json-schema/capacities-io-create-object-from-url-properties-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/capacities-io:capacities-io-space-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

capacities-io-space-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Capacities Space API
  version: 1.0.0
  termsOfService: https://capacities.io/terms-and-conditions
  description: 'Interactive **reference** for all routes of the Capacities API.


    You can add your `cap-api-…` token in the **`Bearer Token`** field to make requests in this dashboard.'
  x-scalar-sdk-installation:
  - lang: Node
    description: 'Install the Capacities TypeScript SDK:'
    source: "npm install @capacities/api\n\nconst capacities = new CapacitiesClient({\n  apiToken: 'cap-api-1lNgD7****' \n})"
servers:
- url: https://api.capacities.io
security:
- bearerAuth: []
tags:
- name: Space
  description: Space related operations
paths:
  /space:
    get:
      summary: Get space
      description: 'Returns information about the space associated with the API token.


        **Rate limit**: 10 requests per 60 seconds'
      tags:
      - Space
      x-codeSamples:
      - label: TypeScript SDK
        lang: Node
        source: "import { CapacitiesClient } from '@capacities/api'\n\nconst capacities = new CapacitiesClient({\n  apiToken: 'cap-api-1lNgD7****',\n})\n\nconst space = await capacities.space.get()"
      responses:
        '200':
          description: 200 OK
          content:
            application/json:
              example:
                id: ac7abb59-b1fd-4102-b549-78e5443610ac
                title: Notes
                icon:
                  type: iconify
                  val: ph-lightbulb
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                    description: Unique identifier of the space.
                  title:
                    type: string
                    description: Display title of the space.
                  icon:
                    description: Icon of the space, if set.
                    allOf:
                    - $ref: '#/components/schemas/ApiIconOutput'
                required:
                - id
                - title
                additionalProperties: false
      operationId: getSpace
      x-operation-id-source: derived
  /space/structures:
    get:
      summary: Get space structures
      description: 'Returns structures visible in the space, including property definitions and collections. See Structures and Properties.


        **Rate limit**: 10 requests per 60 seconds'
      tags:
      - Space
      x-codeSamples:
      - label: TypeScript SDK
        lang: Node
        source: "import { CapacitiesClient } from '@capacities/api'\n\nconst capacities = new CapacitiesClient({\n  apiToken: 'cap-api-1lNgD7****',\n})\n\nconst { structures } = await capacities.space.structures()"
      responses:
        '200':
          description: 200 OK
          content:
            application/json:
              example:
                structures:
                - id: 4ba6e5c6-3f31-45f2-93a0-27a8b2d91551
                  title: Book
                  pluralName: Books
                  propertyDefinitions:
                  - id: title
                    name: ''
                    type: title
                    writable: true
                  - id: status
                    name: Status
                    type: label
                    writable: true
                    multiple: false
                    labelSet:
                    - id: not-started
                      name: Not started
                    - id: in-progress
                      name: In progress
                    - id: done
                      name: Done
                  labelColor: purple
                  collections:
                  - id: 5cd11f44-88f9-448b-9875-af8ff1a5b2b9
                    title: Favorites
              schema:
                type: object
                properties:
                  structures:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          anyOf:
                          - type: string
                            format: uuid
                            pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          - type: string
                            enum:
                            - RootSpace
                            - User
                            - UserPersonal
                            - RootDatabase
                            - RootQuery
                            - RootPage
                            - RootStructure
                            - RootEntity
                            - RootBlocksTemplate
                            - MediaImage
                            - MediaPDF
                            - MediaAudio
                            - MediaVideo
                            - MediaWebResource
                            - MediaFile
                            - MediaTweet
                            - RootAIChat
                            - RootSimpleTable
                            - RootWhiteboard
                            - RootDailyNote
                            - RootTag
                            - UtilDate
                            - RootTask
                          description: Structure id (UUID for custom types, or a built-in id such as RootPage).
                        title:
                          type: string
                          description: Singular display name of the structure.
                        pluralName:
                          type: string
                          description: Plural display name of the structure.
                        propertyDefinitions:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: Stable property definition id (UUID or built-in key such as `title`).
                              name:
                                type: string
                                description: Display name of the property.
                              type:
                                type: string
                                enum:
                                - title
                                - text
                                - number
                                - boolean
                                - url
                                - date
                                - label
                                - entity
                                - aliases
                                - icon
                                - createdAt
                                - lastUpdatedAt
                                - richText
                                description: Property value type.
                              writable:
                                type: boolean
                                description: Whether the property can be set on create or update.
                              multiple:
                                description: 'When `type` is `label`: `true` if multiple options may be selected, `false` for single-select.'
                                type: boolean
                              labelSet:
                                description: Fixed selectable options when `type` is `label`. Omitted for other property types.
                                type: array
                                items:
                                  $ref: '#/components/schemas/ApiLabelOptionOutput'
                              allowedStructures:
                                description: 'When `type` is `entity`: structure ids of objects that may be linked in this property.'
                                type: array
                                items:
                                  type: string
                            required:
                            - id
                            - name
                            - type
                            - writable
                            additionalProperties: false
                          description: Property definitions for this structure.
                        labelColor:
                          type: string
                          description: Hex color used as the label color for this structure.
                        collections:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                description: Unique identifier of the collection (database).
                              title:
                                type: string
                                description: Display title of the collection.
                            required:
                            - id
                            - title
                            additionalProperties: false
                          description: Non-default collections (databases) that use this structure.
                      required:
                      - id
                      - title
                      - pluralName
                      - propertyDefinitions
                      - labelColor
                      - collections
                      additionalProperties: false
                    description: Visible structures in the space.
                required:
                - structures
                additionalProperties: false
      operationId: getSpaceStructures
      x-operation-id-source: derived
components:
  schemas:
    ApiLabelOptionOutput:
      type: object
      properties:
        id:
          type: string
          description: Stable option id from the property definition.
        name:
          type: string
          description: Display label.
        color:
          description: Theme color key for the option, if set.
          type: string
      required:
      - id
      - name
      additionalProperties: false
      description: Selectable option for single and multi label properties.
    ApiIconOutput:
      type: object
      properties:
        type:
          type: string
          enum:
          - emoji
          - iconify
          description: Icon variant — `emoji` for an emoji character, `iconify` for a regular Phosphor icon ID. See https://phosphoricons.com/.
        val:
          type: string
          description: The icon value. For `emoji`, use a single emoji. For `iconify`, use regular Phosphor `ph-name` syntax only, for example `ph-star`; styled variants such as `-duotone`, `-fill`, `-bold`, `-light`, and `-thin` are not accepted.
      required:
      - type
      - val
      additionalProperties: false
      description: Object or space icon value.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
x-scalar-environments:
  production:
    description: Production
    color: '#0082D0'
    variables:
    - name: apiUrl
      value:
        description: Capacities API base URL
        default: https://api.capacities.io
    - name: apiToken
      value:
        description: Bearer token (prefix cap-api-)
        default: ''
  development:
    description: Local development
    color: '#16A34A'
    variables:
    - name: apiUrl
      value:
        description: Local portal API base URL
        default: http://localhost:3000/api
    - name: apiToken
      value:
        description: Bearer token (prefix cap-api-)
        default: ''
x-scalar-active-environment: production