|API Referencev1.0.0
Raw JSON
redocly logoAPI docs by Redocly

Backspace API (1.0.0)

Download OpenAPI specification:Download

URL: https://vzoylukhrl-ci5d6dfkoa-uk.a.run.app

The Backspace public API — commit and retrieve AI chat history across platforms. Backspace is the cross-platform data interchange bridge for AI interactions: commit your context, retrieve it on any platform, share reusable skills.

Commit a chat session to the vault

Push a conversation from your AI platform to the user's Backspace vault. This is the equivalent of git push — the conversation is versioned, timestamped, and stored under the user's encrypted repository.

Authorizations:
bearerAuth
Request Body schema: application/json
required
chatId
required
string

A stable unique identifier for this conversation on your platform. Used to deduplicate and update existing entries.

required
Array of objects (Message)

The full ordered list of messages in this conversation.

title
string

Human-readable title for this conversation.

platform
string

The source platform name (e.g. 'ollama', 'lm-studio', 'chatgpt'). Defaults to the platform associated with your API token.

category
string

Category tag for this conversation (e.g. 'coding', 'research').

model
string

The AI model used for this conversation (e.g. 'llama3.2', 'gpt-4o').

tags
Array of strings

Optional tags for filtering and search.

Responses

Request samples

Content type
application/json
{
  • "chatId": "string",
  • "title": "string",
  • "platform": "string",
  • "category": "string",
  • "messages": [
    ],
  • "model": "string",
  • "tags": [
    ]
}

Response samples

Content type
application/json
{
  • "success": true,
  • "entryId": 0,
  • "message": "string"
}

Pull context entries from the vault

Retrieve the user's stored conversations from Backspace. This is the equivalent of git pull — the AI platform can fetch prior context to avoid re-training from scratch. Entries are returned with encrypted content; decryption happens client-side.

Authorizations:
bearerAuth
query Parameters
platform
string

Filter entries by source platform. Omit to retrieve from all platforms.

category
string

Filter entries by category tag.

limit
integer <= 100
Default: 20

Maximum number of entries to return (default: 20, max: 100).

search
string

Full-text search across entry titles and topics.

Responses

Response samples

Content type
application/json
{
  • "entries": [
    ],
  • "total": 0,
  • "platform": "string"
}

API health check

Returns the current API status. No authentication required.

Responses

Response samples

Content type
application/json
{
  • "status": "string",
  • "service": "string",
  • "version": "string",
  • "timestamp": "string"
}