Build

API

The Deep Thought Cloud REST API, part of Premium: authentication, upload, sources, search and actions.

Sketch: a blank card passing through a mail slot and continuing as smaller cards sorted into three trays; the slot rim carries the gradient.

The REST API is the platform the apps themselves use. It is part of Premium.

Base URL: https://api.deep-thought.cloud/api/v1

Authentication

HTTP Basic, for your scripts: curl -u username:password, or Authorization: Basic, on any endpoint. Checked against the plan on every request: without Premium the answer is 402, and an account that leaves Premium loses access on its next call.
Bearer token, for the apps: POST /api/v1/auth/login, or Sign in with Apple or Google, returns the token the Web App and record-me use. Send it as Authorization: Bearer <token>.
Device tokens, for Trillian: Paired in the browser, limited to scopes (kb:read, kb:write, graph:read) and revocable in the Web App under Settings, Devices.
OAuth, for MCP clients: Issued when you sign in from an AI assistant. See the MCP page.

The main endpoints

Paths are relative to the base URL.

Method	Path	What it does
`POST`	`/sources/upload`	Upload a file for processing: audio, video, PDF, image or document. Optional language hint and tags.
`GET`	`/sources/{id}/status`	The processing status of one source.
`GET`	`/sources`	Your sources, with paging and filters (tag, text, content type).
`GET`	`/sources/{id}`	One source: transcript and extraction.
`POST`	`/search`	Semantic search across your sources, optionally narrowed by tag.
`GET`	`/actions`	Your action items.
`POST`	`/actions/create`	Create an action item.

Upload, wait, search

With HTTP Basic, from a terminal:

# 1. Upload. The response carries the id to poll.
curl -u USER:PASSWORD -F file=@meeting.m4a -F language=sv \
  https://api.deep-thought.cloud/api/v1/sources/upload

# 2. Poll until the status is done.
curl -u USER:PASSWORD https://api.deep-thought.cloud/api/v1/sources/SOURCE_ID/status

# 3. Search across everything you have uploaded.
curl -u USER:PASSWORD -H 'Content-Type: application/json' \
  -d '{"query": "what was decided about the launch", "n_results": 5}' \
  https://api.deep-thought.cloud/api/v1/search

What it does not do

It does not push results to you. Poll the status endpoint.
It does not answer a script on the Free plan. The Web App, record-me and Trillian keep working without Premium.

What is planned is on the integrations page. Integrations