Thermidora API

Create a new account. An invite code is required during the beta period.

{
  "name": "string (required)",
  "email": "string (required)",
  "inviteCode": "string (required)"
}

{
  "accountId": "acc_...",
  "email": "user@example.com",
  "name": "User Name",
  "token": "eyJ..."
}

Request a one-time login code sent to your email.

{
  "email": "string (required)"
}

{
  "message": "OTP sent to email"
}

Verify the OTP code and receive a JWT token.

{
  "email": "string (required)",
  "code": "string (required, 6-digit OTP)"
}

{
  "accountId": "acc_...",
  "token": "eyJ..."
}

Get current account info including balance.

{
  "accountId": "acc_...",
  "email": "user@example.com",
  "name": "User Name",
  "balanceUsd": 50.00
}

Create an API key for programmatic access.

{
  "name": "string (required)"
}

{
  "keyId": "key_...",
  "apiKey": "tc_live_...",
  "name": "my-key"
}

List all API keys for your account.

Delete an API key.

Create a new instance. Provisioning is async — poll GET /instances/:id until status is "running" (~90 seconds).

{
  "name": "string (required)"
}

{
  "instanceId": "inst_...",
  "name": "my-agents",
  "status": "provisioning",
  "agents": []
}

List all instances. Status is resolved live from the underlying infrastructure.

Get instance details including live status and agent list.

{
  "instanceId": "inst_...",
  "name": "my-agents",
  "status": "running",
  "agents": [
    { "agentId": "agt_...", "slug": "support-bot", "status": "active" }
  ],
  "startedAt": "2026-04-07T...",
  "totalRuntimeMs": 3600000,
  "billedMs": 3600000
}

Start a stopped instance. Resumes compute — billing restarts.

{ "instanceId": "inst_...", "status": "running" }

Stop an instance. Compute is deallocated — no charges while stopped. Storage persists.

{ "instanceId": "inst_...", "status": "stopped" }

Permanently delete an instance and all its data.

{ "instanceId": "inst_...", "status": "destroying" }

Create a new agent. Use useDefaults: true to seed standard workspace files, or provide custom files for full control over persona.

{
  "name": "string (required)",
  "slug": "string (required, 2-32 chars, lowercase + hyphens)",
  "displayName": "string (required)",
  "model": "string (optional, default: moonshotai.kimi-k2.5)",
  "useDefaults": true,
  "files": {
    "SOUL.md": "Be helpful and concise...",
    "IDENTITY.md": "Name: Support Bot"
  }
}

{
  "agentId": "agt_...",
  "slug": "support-bot",
  "displayName": "Support Bot",
  "model": "moonshotai.kimi-k2.5",
  "status": "active"
}

List all agents in an instance.

Get agent details.

Update agent name, displayName, or workspace files.

{
  "displayName": "string (optional)",
  "files": {
    "SOUL.md": "Updated persona..."
  }
}

Delete an agent and its workspace.

Send a message to an agent. Include stream: true for Server-Sent Events streaming.

{
  "message": "string (required)",
  "sender": {
    "type": "human",
    "id": "user-123",
    "name": "Jeff"
  },
  "stream": false
}

{
  "messageId": "msg_...",
  "content": "Here's what I found...",
  "sender": {
    "type": "agent",
    "id": "support-bot",
    "name": "Support Bot"
  },
  "timestamp": "2026-04-07T..."
}

Get message history for an agent.

limit   max messages (default 50)

Create a webhook subscription. Optionally scope to a specific instance or agent.

{
  "url": "https://example.com/webhook (required, HTTPS only)",
  "events": ["cron.completed", "agent.message"],
  "instanceId": "inst_... (optional)",
  "description": "string (optional)"
}

{
  "webhookId": "wh_...",
  "url": "https://example.com/webhook",
  "events": ["cron.completed", "agent.message"],
  "secret": "whsec_...",
  "enabled": true
}

List all webhook subscriptions. Secrets are partially masked.

Get full webhook details including unmasked secret.

Enable or disable a webhook.

{
  "enabled": false
}

Delete a webhook subscription.

Send a test event to verify your endpoint is reachable.

{ "message": "Test event dispatched" }

List recent events for an instance. Filter by agent or source type.

limit   max events, default 50, max 200
agent   filter by agent slug
source  filter by source: cron, agent

{
  "events": [
    {
      "messageId": "msg_...",
      "content": "Bitcoin price: $69,327",
      "sender": { "type": "agent", "id": "my-agent", "name": "my-agent" },
      "source": "cron",
      "createdAt": "2026-04-07T09:00:00.000Z",
      "agentSlug": "my-agent"
    }
  ],
  "total": 1
}

List all available built-in skills. No authentication required.

[
  {
    "id": "weather",
    "name": "Weather",
    "description": "Get current weather and forecasts",
    "type": "built-in"
  }
]

Install a built-in skill or upload a custom skill with files.

// Built-in:
{ "name": "weather", "type": "built-in" }

// Custom:
{
  "name": "my-skill",
  "description": "Custom skill",
  "files": {
    "SKILL.md": "# My Skill\n...",
    "scripts/run.py": "#!/usr/bin/env python3\n..."
  }
}

List skills installed on an instance.

Uninstall a skill.

List secret keys. Values are never exposed.

{
  "secrets": [
    { "key": "OPENAI_API_KEY" },
    { "key": "SLACK_TOKEN" }
  ]
}

Store one or more secrets. Triggers an instance restart to inject them.

{
  "secrets": {
    "OPENAI_API_KEY": "sk-...",
    "SLACK_TOKEN": "xoxb-..."
  }
}

{ "stored": 2, "restarting": true }

Delete a secret.