Question 1

Get your spaces

Accepted Answer

Auth Required

Returns information about your personal spaces.

**Rate limit**: 5 requests per 60 seconds ( [Learn more](https://docs.capacities.io/developer/api#rate-limits))

Responses

- 200

200 OK

application/json

Request Example for get/spaces

Shell Curl

```curl
curl https://api.capacities.io/spaces \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
```

cURLCopy

Test Request(get /spaces)

Status: 200

Show Schema

```json
{
  "spaces": [\
    {\
      "id": "string",\
      "title": "string",\
      "icon": {\
        "type": "emoji",\
        "val": "string",\
        "color": "gray",\
        "colorHex": "string"\
      }\
    }\
  ]
}
```

JSONCopy

200 OK

Question 2

Get structures and collections of a space

Accepted Answer

Auth Required

Returns all structures (object types) with property definitions and collections of a space.

**Rate limit**: 5 requests per 60 seconds ( [Learn more](https://docs.capacities.io/developer/api#rate-limits))

Query Parameters

- spaceidCopy link to spaceid

Type: string` 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)$`Format: uuid

required

[Learn more](https://docs.capacities.io/developer/api#content-ids)

Responses

- 200

200 OK

application/json

Request Example for get/space-info

Shell Curl

```curl
curl 'https://api.capacities.io/space-info?spaceid=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
```

cURLCopy

Test Request(get /space-info)

Status: 200

Show Schema

```json
{
  "structures": [\
    {\
      "id": "string",\
      "title": "string",\
      "pluralName": "string",\
      "propertyDefinitions": [\
        {\
          "id": "string",\
          "type": "string",\
          "name": "string",\
          "writable": true\
        }\
      ],\
      "labelColor": "string",\
      "collections": [\
        {\
          "id": "string",\
          "title": "string"\
        }\
      ]\
    }\
  ]
}
```

JSONCopy

200 OK

Question 3

Lookup content

Accepted Answer

Auth Required

Returns the id and structureId of a content based on a title matching the search term.

**Rate limit**: 120 requests per 60 seconds ( [Learn more](https://docs.capacities.io/developer/api#rate-limits))

Body

application/json

- searchTermCopy link to searchTerm

Type: string

required

Example

My note

- spaceIdCopy link to spaceId

Type: string` 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)$`Format: uuid

required

[Learn more](https://docs.capacities.io/developer/api#content-ids)

Responses

- 200

200 OK

application/json

Request Example for post/lookup

Shell Curl

```curl
curl https://api.capacities.io/lookup \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "searchTerm": "My note",
  "spaceId": ""
}'
```

cURLCopy

Test Request(post /lookup)

Status: 200

Show Schema

```json
{
  "results": [\
    {\
      "id": "123e4567-e89b-12d3-a456-426614174000",\
      "structureId": "123e4567-e89b-12d3-a456-426614174000",\
      "title": "string"\
    }\
  ]
}
```

JSONCopy

200 OK

Question 4

Save a weblink to a space

Accepted Answer

Auth Required

Object type of weblink will be analyzed and saved as an object to your space.

**Rate limit**: 10 requests per 60 seconds ( [Learn more](https://docs.capacities.io/developer/api#rate-limits))

Body

application/json

- spaceIdCopy link to spaceId

Type: string` 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)$`Format: uuid

required

[Learn more](https://docs.capacities.io/developer/api#content-ids)

- urlCopy link to url

Type: stringFormat: uri

required

- descriptionOverwriteCopy link to descriptionOverwrite

Type: string
max length:
1000

If not specified, the description will be fetched from the URL

- mdTextCopy link to mdText

Type: string
max length:
200000

Example

This is a **note** for the weblink

Text formatted as markdown that will be added to the notes section

- tagsCopy link to tags

Type: array string":[

Example

["todo", "important"]

Tags to add to the weblink. Tags need to exactly match your tag names in Capacities, otherwise they will be created.

- titleOverwriteCopy link to titleOverwrite

Type: string
max length:
500

Example

My custom title

If not specified, the title will be fetched from the URL

Responses

- 200

200 OK

application/json

Request Example for post/save-weblink

Shell Curl

```curl
curl https://api.capacities.io/save-weblink \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "spaceId": "",
  "url": "",
  "titleOverwrite": "My custom title",
  "descriptionOverwrite": "",
  "tags": [\
    "todo",\
    "important"\
  ],
  "mdText": "This is a **note** for the weblink"
}'
```

cURLCopy

Test Request(post /save-weblink)

Status: 200

Show Schema

```json
{
  "spaceId": "123e4567-e89b-12d3-a456-426614174000",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "structureId": "123e4567-e89b-12d3-a456-426614174000",
  "title": "string",
  "description": "string",
  "tags": [\
    "string"\
  ]
}
```

JSONCopy

200 OK

Question 5

Save text to today's daily note

Accepted Answer

Auth Required

Saves a text to today's daily note in a space. The text can be formatted in markdown. Do not use this to import large amounts of content as this could break the daily note. Use the import system of Capacities instead.

**Rate limit**: 5 requests per 60 seconds ( [Learn more](https://docs.capacities.io/developer/api#rate-limits))

Body

application/json

- mdTextCopy link to mdText

Type: string
max length:
200000

required

Example

[ ] My important task

Markdown text that should be added to today's daily note

- spaceIdCopy link to spaceId

Type: string` 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)$`Format: uuid

required

[Learn more](https://docs.capacities.io/developer/api#content-ids)

- noTimeStampCopy link to noTimeStamp

Type: boolean

Example

true

If true, no time stamp will be added to the note

- originCopy link to origin

Type: stringenum

The origin of the save action. This determines the icon added to your note.

values

- commandPalette

- mcp

Responses

- 200

200 OK

Request Example for post/save-to-daily-note

Shell Curl

```curl
curl https://api.capacities.io/save-to-daily-note \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "spaceId": "",
  "mdText": "[ ] My important task",
  "origin": "commandPalette",
  "noTimeStamp": true
}'
```

cURLCopy

Test Request(post /save-to-daily-note)

Status: 200

No Body

200 OK

Capacities

About Capacities

Quick facts about Capacities

Key Features

Object Creation

Knowledge Networking

Daily Management

Editing & Formatting

Integrations

Data Security

Use Cases

Pricing

Integrations(3)

Built for

Frequently asked questions

Reviews (0)

Quick Info

Traffic Sources

Alternatives to Capacities

Aisera

Miro

Copy.ai

Taskade Genesis

Raycast

Compare Capacities head-to-head