SoLoRecall LogoSoLoRecall
Developer platform

SoLoRecall API

Build external apps with the same SoLoDocs capabilities available in the web app: blocks, page exports, comments, mentions, backlinks, synced blocks, and media.

Open interactive docsOpenAPI JSON
47
documented endpoints
7
API groups
Bearer
authentication
Quickstart
curl -X POST "https://api.solorecall.com/api/v1/blocks" \
  -H "Authorization: Bearer $SOLORECALL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "paragraph",
  "properties": {
    "content": "Created from the SoLoRecall API"
  }
}'
1

Get an access token for the SoLoRecall workspace user.

2

Send the token with every request as Authorization: Bearer $SOLORECALL_TOKEN.

3

Use the endpoint explorer below or the OpenAPI JSON for exact paths and methods.

Overview

The SoLoRecall API is organized around SoLoDocs resources. Use the public reference for discovery, then use the OpenAPI JSON as the exact machine-readable contract for generated clients and integration tests.

Base URL
https://api.solorecall.com
Canonical Spec
https://api.solorecall.com/documentation/openapi.json

Authentication

Pass a valid SoLoRecall bearer token in the Authorization header.

Authorization: Bearer $SOLORECALL_TOKEN

Endpoint Explorer

Search the public SoLoDocs API surface and inspect a request example for each endpoint.

Blocks
GET/api/v1/blocks

List and search visible blocks

curl -X GET "https://api.solorecall.com/api/v1/blocks" \
  -H "Authorization: Bearer $SOLORECALL_TOKEN"
Example response shape
{
  "id": "block_123",
  "type": "paragraph",
  "properties": {
    "content": "Created from the SoLoRecall API"
  },
  "created_by": "user_123",
  "last_edited_by": "user_123"
}

Response fields vary by endpoint. Use the OpenAPI JSON for exact request and response schemas.

Blocks

Create, read, update, move, archive, trash, restore, duplicate, convert, and delete SoLoDocs blocks.

GET/api/v1/blocksList and search visible blocks
POST/api/v1/blocksCreate a block
GET/api/v1/blocks/{id}Fetch one block
PATCH/api/v1/blocks/{id}Update a block
DELETE/api/v1/blocks/{id}Permanently delete a block
GET/api/v1/blocks/{id}/childrenList child blocks
GET/api/v1/blocks/{id}/hierarchyFetch a block hierarchy
POST/api/v1/blocks/{id}/duplicateDuplicate a block
POST/api/v1/blocks/{id}/convertConvert a block type
POST/api/v1/blocks/{id}/archiveArchive or unarchive a block
POST/api/v1/blocks/{id}/trashMove a block to trash
POST/api/v1/blocks/{id}/restoreRestore a trashed block
POST/api/v1/blocks/{id}/moveMove or reorder a block

Pages And Exports

Compatibility endpoints for page-like blocks and markdown, HTML, JSON, and batch exports.

GET/api/v1/pagesList page-like blocks
POST/api/v1/pagesCreate a page-like block
GET/api/v1/pages/{id}Fetch one page-like block
PUT/api/v1/pages/{id}Update a page-like block
DELETE/api/v1/pages/{id}Trash or permanently delete a page
GET/api/v1/pages/{id}/exportExport as md, html, or json
GET/api/v1/pages/export/batchBatch export pages

Comments

Threaded collaboration primitives for blocks and page-like blocks.

GET/api/v1/comments/block/{blockId}List block comments
GET/api/v1/comments/page/{pageId}List page comments
POST/api/v1/commentsCreate a comment
PATCH/api/v1/comments/{id}Update a comment
DELETE/api/v1/comments/{id}Delete a comment
POST/api/v1/comments/{id}/resolveResolve a comment
POST/api/v1/comments/{id}/unresolveReopen a comment

Mentions

Inline mention creation, lookup, update, delete, and sync.

GET/api/v1/mentions/block/{blockId}List block mentions
GET/api/v1/mentions/page/{pageId}List page mentions
POST/api/v1/mentionsCreate a mention
POST/api/v1/mentions/syncSync mentions from content
PATCH/api/v1/mentions/{id}Update a mention
DELETE/api/v1/mentions/{id}Delete a mention

Synced Blocks

Manage source blocks, synced instances, propagation, and unlinking.

GET/api/v1/synced-blocks/source/{sourceBlockId}List synced instances for a source
GET/api/v1/synced-blocks/instance/{instanceBlockId}Fetch synced block metadata
POST/api/v1/synced-blocksCreate synced block metadata
POST/api/v1/synced-blocks/source/{sourceBlockId}/propagatePropagate source changes
POST/api/v1/synced-blocks/instance/{instanceBlockId}/unlinkUnlink an instance

Media

Upload, search, fetch URLs, update metadata, and delete SoLoDocs media.

GET/api/v1/mediaList media files
POST/api/v1/media/uploadUpload media
GET/api/v1/media/searchSearch media
GET/api/v1/media/{id}/urlGet a signed media URL
GET/api/v1/media/{id}/metadataFetch media metadata
PATCH/api/v1/media/{id}/metadataUpdate media metadata
DELETE/api/v1/media/{id}Delete media

Production Access

External API access is intended for SoLoRecall workspace integrations. Contact support for production access, rate-limit planning, and token provisioning.

Contact SupportSwagger UIOpenAPI JSON