Misc resources API

{
  records: Array<{
    id: number
    agentId: string
    model: string
    inputTokens: number
    outputTokens: number
    costUsd: number
    runId: string | null
    createdAt: number // epoch ms
  }>
}

{ "error": "<message>" }

curl "http://localhost:18790/api/cost-records?period=week&agentId=<agent-id>"

{
  agentId: string        // required
  model: string          // required (drives the pricing lookup)
  inputTokens: number    // required (0 is allowed; only null/undefined fails)
  outputTokens: number   // required
  runId?: string | null  // optional run correlation id
}

{ "error": "invalid JSON" }

{ "error": "agentId, model, inputTokens, outputTokens required" }

{ ok: true, record: { id: number, agentId: string, model: string, inputTokens: number, outputTokens: number, costUsd: number, runId: string | null, createdAt: number } }

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/cost-records \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"<agent-id>","model":"claude-sonnet-4-6","inputTokens":1200,"outputTokens":340}'

{
  totalToday: number // USD
  totalWeek: number
  totalMonth: number
  tokensToday: number
  tokensWeek: number
  tokensMonth: number
  byAgent: Array<{
    agentId: string
    agentName: string // joined from agents.name, falls back to agentId
    totalCost: number
    totalTokens: number
    inputTokens: number
    outputTokens: number
    messageCount: number
  }> // sorted by totalTokens desc
  timeSeries: Array<{
    date: string // 'Mon D' label, en-US locale
    cost: number
    tokens: number
  }> // exactly 30 entries, oldest first, zero-filled
}

{ "error": "<message>" }

curl http://localhost:18790/api/cost-records/summary

{ "error": "sessionKey required" }

{
  entries: TranscriptEntry[]
  hasMore: boolean            // true when older messages exist
  nextBefore: number | null   // pass back as `before`; null once the start is reached
}

{ "error": "<message>" }

curl "http://localhost:18790/api/chat-history?sessionKey=<session-key>&limit=500"

{
  sessionKey: string          // required
  gatewayUrl: string          // stored on each row (defaults to '' if absent)
  entries: TranscriptEntry[]  // required, non-empty
}

{ "error": "invalid JSON" }

{ "error": "sessionKey and entries[] required" }

{ ok: true, saved: number }

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/chat-history \
  -H 'Content-Type: application/json' \
  -d '{"sessionKey":"<session-key>","gatewayUrl":"ws://localhost:18789","entries":[{"entryId":"e1","timestampMs":1700000000000}]}'

{
  sessionKeys: string[]        // required, non-empty
  noticeSessionKey?: string    // must be one of sessionKeys; defaults to the first
}

{ "error": "sessionKeys[] required" }

{ "error": "noticeSessionKey must be one of sessionKeys" }

{ ok: true, entry: TranscriptEntry }

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/chat-history/reset-context \
  -H 'Content-Type: application/json' \
  -d '{"sessionKeys":["agent:my-boo:native"]}'

{ "error": "sessionKey required" }

{ "ok": true }

{ "error": "<message>" }

curl -X DELETE "http://localhost:18790/api/chat-history?sessionKey=<session-key>"

{
  positions: Record<string, { x: number; y: number }>
}

curl "http://localhost:18790/api/graph-layout?name=team-<team-id>&url=ws://localhost:18789"

{
  name?: string                                          // default 'default'
  positions: Record<string, { x: number; y: number }>   // serialized to layoutData
  gatewayUrl: string                                     // required
}

{ "ok": false, "error": "invalid JSON" }

{ "ok": false, "error": "gatewayUrl required" }

{ "ok": true }

{ "ok": false, "error": "<message>" }

curl -X POST http://localhost:18790/api/graph-layout \
  -H 'Content-Type: application/json' \
  -d '{"name":"team-<team-id>","gatewayUrl":"ws://localhost:18789","positions":{"boo-a1":{"x":120,"y":40}}}'

{ "error": "agentId required" }

{ values: Record<string, number> | null, customText: string | null }

{ "error": "<message>" }

curl "http://localhost:18790/api/personality?agentId=<agent-id>"

{
  agentId: string                  // required
  values: Record<string, number>  // required (e.g. { verbosity: 50, humor: 50, ... })
  customText?: string | null      // optional; trimmed; blank → null
}

{ "error": "invalid JSON" }

{ "error": "agentId and values required" }

{ "ok": true }

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/personality \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"<agent-id>","values":{"verbosity":60,"humor":40},"customText":"Concise, dry."}'

{
  ok: true
  skills: Array<{
    id: string
    name: string
    source: string // free-text provenance (e.g. 'curated'); not an external registry
    category: string | null
    trustScore: number | null // retained column, no longer populated
    installedAt: number | null
    metadata: string | null // JSON; { agentIds: string[] }
  }>
}

{ "ok": false, "error": "<message>", "skills": [] }

curl "http://localhost:18790/api/skills?agentId=<agent-id>"

{
  id: string               // required
  name: string             // required
  source: string           // required (e.g. 'curated')
  agentId: string          // required
  category?: string | null
}

{ "ok": false, "error": "Invalid JSON body" }

{ "ok": false, "error": "id, name, source, and agentId are required" }

{
  ok: false
  error: 'skill blocked: injection / supply-chain finding'
  findings: Array<{
    severity: 'exfil' | 'injection' | 'destructive' | 'supply-chain'
    pattern: string
    excerpt: string
  }>
}

{ ok: true, skill: { id: string, name: string, source: string, category: string | null, trustScore: number | null, installedAt: number | null, metadata: string | null } | null }

{ "ok": false, "error": "<message>" }

curl -X POST http://localhost:18790/api/skills \
  -H 'Content-Type: application/json' \
  -d '{"id":"web-search","name":"Web Search","source":"curated","agentId":"<agent-id>","category":"web"}'

{ "ok": false, "error": "id and agentId query params are required" }

{ "ok": true, "deleted": false, "reason": "skill not found" }

{ "ok": true, "deleted": true, "removedRow": true }

{ "ok": true, "deleted": true, "removedRow": false }

{ "ok": false, "error": "<message>" }

curl -X DELETE "http://localhost:18790/api/skills?id=web-search&agentId=<agent-id>"

{
  "schemaVersion": 1,
  "counts": { "agents": 436, "teams": 85 },
  "agents": [
    {
      "id": "clawboo-dev-code-reviewer-boo",
      "packId": "clawboo",
      "source": "clawboo",
      "name": "Code Reviewer Boo",
      "role": "Code Reviewer",
      "emoji": "🔍",
      "color": "#34D399",
      "description": "Reviews diffs for correctness, security and style.",
      "category": "engineering",
      "tags": ["review", "quality"],
      "skillIds": ["code-search"]
    }
  ],
  "teams": [
    {
      "id": "clawboo-dev",
      "packId": "clawboo",
      "source": "clawboo",
      "name": "Dev Squad",
      "emoji": "🛠️",
      "color": "#34D399",
      "description": "Ships code: fix, review, document.",
      "category": "engineering",
      "tags": ["dev"],
      "agentIds": ["clawboo-dev-bug-fixer-boo", "clawboo-dev-code-reviewer-boo"]
    }
  ],
  "packs": [
    {
      "publisher": "clawboo",
      "slug": "builtin",
      "id": "clawboo",
      "version": "1.0.0",
      "offline": true
    }
  ]
}

{
  "id": "clawboo-dev-code-reviewer-boo",
  "files": {
    "SOUL.md": "# SOUL\n\n...",
    "IDENTITY.md": "# Code Reviewer Boo\n\n...",
    "TOOLS.md": "# TOOLS\n\n## Skills\n- code-search"
  },
  "sourceUrl": "https://github.com/..."
}

{
  "id": "clawboo-dev",
  "workflowNarrative": "...",
  "routing": { "clawboo-dev-bug-fixer-boo": "# AGENTS\n\n..." }
}

{ "error": "agentId required" }

{ values: { execAsk: string; execSecurity?: string } | null }

{ "error": "<message>" }

curl "http://localhost:18790/api/exec-settings?agentId=<agent-id>"

{
  configs: Record<string, { execAsk: string }>
}

{ "error": "<message>" }

curl http://localhost:18790/api/exec-settings/all

{
  agentId: string
  values: { execAsk: string; execSecurity?: string }
}

{ "error": "invalid JSON" }

{ "error": "agentId and values required" }

{ "ok": true, "gateway": "applied" }

{ "ok": true, "gateway": "not-applicable" }

{ "error": "unknown execAsk: <value>" }

{
  "ok": false,
  "savedLocally": true,
  "error": "saved in clawboo, but the Gateway did not accept it: <reason>"
}

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/exec-settings \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"<agent-id>","values":{"execAsk":"always","execSecurity":"sandbox"}}'

{ "error": "agentId required" }

{ "error": "agent not found" }

{
  state: 'ok'
  sourceAgentId: string // OpenClaw's id for this Boo
  entries: ExecAllowlistRow[] // this Boo's bucket
  wildcard: ExecAllowlistRow[] // agents['*'], live here, not revocable here
  duplicatedInWildcard: string[] // keys present in BOTH buckets
  storedSecurity: string | null // what OpenClaw holds for this Boo
  storedAsk: string | null
  defaultSecurity: string | null // document-level defaults an absent field falls through to
  defaultAsk: string | null
  updatedAtMs: number
}

interface ExecAllowlistRow {
  key: string // content fingerprint, and the handle a revoke uses
  pattern: string
  argPattern: string | null
  source: string | null
  classification:
    | 'bound-grant' // one exact command, in one exact folder
    | 'exact-command-grant' // one exact command, any folder
    | 'path-rule' // this program, any arguments, any folder
    | 'arg-rule' // this program, matching arguments
    | 'catch-all' // any command at all
    | 'node-marker' // the companion row a mint produces; grants nothing alone
    | 'inert-allow-always' // an Always the engine skips
    | 'inert' // malformed or unreachable
  bucket: 'agent' | 'wildcard'
  lastUsedCommand: string | null // never present for an operator-minted grant
  lastResolvedPath: string | null
  lastUsedAt: number | null
}

{ "state": "absent", "sourceAgentId": "<openclaw-agent-id>" }

{ "state": "not-applicable", "runtime": "clawboo-native" }

{
  state: 'unreadable'
  sourceAgentId: string
  error: string // redacted reason
  knownAgentCount: number
  knownAllowlistCount: number
}

{ "error": "<message>" }

curl "http://localhost:18790/api/exec-allowlist?agentId=<agent-id>"

{
  agentId: string // clawboo's row id
  keys: string[] // 1 to 200 entries, each the `key` from a GET row
}

{ "error": "agentId and a non-empty keys array are required" }

{ "error": "agent not found" }

{ "error": "this runtime keeps no standing exec grants" }

{ "outcome": "revoked", "removed": 2, "remaining": 3 }

{ "outcome": "already-absent", "error": "those grants were already gone" }

{
  "outcome": "blocked-wildcard",
  "keys": ["<key>"],
  "error": "that grant is set for every Boo, not just this one, so it cannot be removed here"
}

{ "outcome": "no-such-agent", "error": "this Boo has no policy to change" }

{
  "outcome": "not-verified",
  "keys": ["<key>"],
  "error": "the Gateway accepted the change and still lists those grants"
}

{ "error": "Too many requests for this operation. Wait a moment and retry." }

{ "state": "failed", "error": "<message>" }

curl -X POST http://localhost:18790/api/exec-allowlist/revoke \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"<agent-id>","keys":["<key-from-the-GET>"]}'

{
  generatedAt: number // epoch ms
  tenantId: null // dormant multi-tenant seam
  totalAgents: number // live (non-archived) agent rows
  runtimes: Array<{
    runtime: string
    runtimeClass: 'connected-substrate' | 'wrapped-oneshot' | 'native'
    healthOk: boolean | null // null when no adapter/source reports for it
    agentCount: number
    healthy: number // status idle | running
    degraded: number // status error
    down: number // sleeping / other
  }> // sorted by agentCount desc, then runtime name
  tasks24h: {
    total: number
    done: number
    cancelled: number
    inProgress: number // in_progress | in_review
    passRate: number | null // done / (done + cancelled); null if no terminal tasks
  }
  verification24h: {
    total: number
    pass: number
    fail: number
    debt: number // completed_with_debt
    passRate: number | null // pass / total; null if no verdicts
  }
  spend24hUsd: number // summed task costUsd over the last 24h
  budgets: {
    count: number
    paused: number
  }
}

{ "error": "<message>" }

curl http://localhost:18790/api/fleet/summary

{ "error": "teamId required" }

{ content: string | null, updatedAt: number | null }

{ "error": "<message>" }

curl http://localhost:18790/api/boo-zero/team-briefs/<team-id>

{
  content: string
} // required (must be a string)

{ "error": "teamId required" }

{ "error": "content (string) required" }

{ content: string, updatedAt: number }

{ "error": "<message>" }

curl -X PUT http://localhost:18790/api/boo-zero/team-briefs/<team-id> \
  -H 'Content-Type: application/json' \
  -d '{"content":"# Team brief\n\nShip the docs site."}'

{ "error": "teamId required" }

{ "ok": true }

{ "error": "<message>" }

curl -X DELETE http://localhost:18790/api/boo-zero/team-briefs/<team-id>

{ content: string | null, updatedAt: number | null }

{ "error": "<message>" }

curl http://localhost:18790/api/boo-zero/global-brief

{
  content: string
} // required (must be a string)

{ "error": "content (string) required" }

{ content: string, updatedAt: number }

{ "error": "<message>" }

curl -X PUT http://localhost:18790/api/boo-zero/global-brief \
  -H 'Content-Type: application/json' \
  -d '{"content":"# Global brief\n\nDefault leadership posture."}'

{ "error": "agentId required" }

{
  name: string | null
}

{ "error": "<message>" }

curl http://localhost:18790/api/boo-zero/display-name/<agent-id>

{
  name: string
} // required (must be a string; '' clears the override)

{ "error": "agentId required" }

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

{
  name: string
}

{ "error": "<message>" }

curl -X PUT http://localhost:18790/api/boo-zero/display-name/<agent-id> \
  -H 'Content-Type: application/json' \
  -d '{"name":"Boo Zero"}'

{
  overrideAgentId: string | null
  effective: { id: string, name: string } | null
  tier: 'override' | 'native' | 'openclaw' | null
}

{ "error": "<message>" }

curl http://localhost:18790/api/boo-zero/override

{
  agentId: string | null
} // required (a non-empty string to set, null to clear)

{ "error": "agentId is required (string to set, null to clear)" }

{ "error": "agentId must be a non-empty string or null" }

{ "error": "agent not found (or archived)" }

{
  ok: true
  overrideAgentId: string | null
  effective: { id: string, name: string } | null
}

{ "error": "<message>" }

# Promote any agent (any runtime) to Boo Zero
curl -X POST http://localhost:18790/api/boo-zero/override \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"<agent-id>"}'

# Clear the override
curl -X POST http://localhost:18790/api/boo-zero/override \
  -H 'Content-Type: application/json' \
  -d '{"agentId":null}'

{
  ok: true
  connectors: Array<{
    connectorId: string
    slug: string
    toolCount: number
    tools: string[]
    skipped: Array<{ name: string; reason: string }>
    specHash: string
    toolsHash: string
  }>
}

{ "error": "<message>" }

curl "http://localhost:18790/api/connectors"

{ ok: true; slugs: string[]; supplied: string[] }

{ "error": "<message>" }

curl "http://localhost:18790/api/connectors/configured"

{
  ok: true
  suggestions: Array<{ label: string; path: string }>
}

{ "error": "that connector does not take a path" }

{ "error": "<message>" }

curl "http://localhost:18790/api/connectors/path-suggestions?slug=filesystem"

{
  ok: true
  connectorId: string
  // The resolved command that actually ran, or the URL for a remote connector.
  command: string
  tools: string[]
  skipped: Array<{ name: string; reason: string }>
}

{ error: 'invalid body'; details: /* zod flatten() output */ }

{ "error": "no catalog connector named <slug>" }

{
  error: string
  reason:
    | 'community-unsandboxed'
    | 'remote-needs-registered-app'
    | 'remote-needs-oauth'
    | 'needs-credential'
    | 'needs-user-supplied-argument'
}

{
  error: string
  detail: string
}

curl -X POST http://localhost:18790/api/connectors/connect \
  -H 'Content-Type: application/json' \
  -d '{"slug":"filesystem"}'