API

REST-API:t är samma plattform som apparna själva använder.

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

Autentisering

Skicka en token i varje anrop: Authorization: Bearer <token>.

Enhetstoken, använd den i dag

Börjar med dtd_. Deep Thought utfärdar den för ditt konto; den visas en gång, så spara den som en hemlighet. Kan återkallas när som helst i webbappen under Inställningar, Enheter. Behörigheter: kb:read (läsa och söka) och kb:write (uppladdning, taggar, åtgärder). Trillian använder också en.

API-nycklar, Enterprise, kommer

För serverintegrationer: en nyckel per system, med begränsad behörighet och möjlig att återkalla, skapad av en kontoägare eller admin i webbappen och skickad på samma sätt (Bearer dtk_...). Inte påslagna än, och inget datum är satt. Att byta från en enhetstoken ändrar bara den token du skickar.

Lösenord och HTTP Basic: bara för apparna

Inloggning med e-post och lösenord, och HTTP Basic, är till för Deep Thoughts appar. Bygg ingen integration på dem. Att använda dem från ett skript avvecklas för alla planer: avisering 2026-10-16, slut 2026-11-16. Från slutdatumet får ett skript 401.

OAuth, för MCP-klienter

Utfärdas när du loggar in från en AI-assistent. Se sidan om MCP.

Planer

REST-API:t för dina egna system ingår i Enterprise, med API-nycklar när de slås på. MCP ingår i Premium.

Webbappen, record-me och Trillian använder samma API och fungerar på alla planer.

Varje endpoint kräver den plan dess funktion hör till; annars blir svaret 402 plan_required. Referensen anger plan och behörighet för varje endpoint.

De viktigaste endpoints

Sökvägarna är relativa till bas-URL:en.

Alla endpoints, behörigheter, gränser och felkoder finns i API-referensen (på engelska), även som Markdown för AI-agenter och andra system.

Läs API-referensen reference.md

Ladda upp, vänta, läs

Med en token, från en terminal (referensens snabbstart, förkortad):

# Din token; checka aldrig in den.
export DT_TOKEN="dtd_..."
API=https://api.deep-thought.cloud/api/v1

# 1. Ladda upp. En ny fil svarar med ett task_id.
TASK=$(curl -s -X POST "$API/sources/upload" -H "Authorization: Bearer $DT_TOKEN" \
  -F "file=@meeting.m4a" -F "language=sv" | jq -r '.task_id // empty')

# 2. Vänta på källans nyckel, sedan på transkriptet.
until KEY=$(curl -s "$API/sources/tasks/$TASK" -H "Authorization: Bearer $DT_TOKEN" \
    | jq -r '.result.cache_key // .cache_key // empty') && [ -n "$KEY" ]; do sleep 10; done
until [ "$(curl -s "$API/sources/$KEY/status" -H "Authorization: Bearer $DT_TOKEN" \
    | jq -r '.status.transcription.status')" = "completed" ]; do sleep 30; done

# 3. Hämta källan: transkript, titel, sammanfattning och extraktion.
curl -s "$API/sources/$KEY" -H "Authorization: Bearer $DT_TOKEN"