Teams API

{
  teams: Array<{
    id: string
    name: string
    icon: string
    color: string
    colorCollectionId: string | null
    templateId: string | null
    leaderAgentId: string | null
    isArchived: number // 0 | 1
    createdAt: number
    updatedAt: number
    agentCount: number // COUNT(*) of agents with this team_id
  }>
  assignments: Array<{ agentId: string; teamId: string }> // agents with a non-null teamId
}

{ "error": "<message>" }

curl http://localhost:18790/api/teams
curl 'http://localhost:18790/api/teams?includeArchived=true'

{
  name: string               // required
  icon: string               // required (emoji)
  color: string              // required (hex)
  colorCollectionId?: string // null when omitted
  templateId?: string        // null when omitted
  leaderAgentId?: string     // null when omitted
  id?: string                // honored only if it matches the UUID regex; else server-minted
}

{ "error": "invalid JSON" }

{ "error": "name, icon, and color are required" }

{
  team: {
    id: string
    name: string
    icon: string
    color: string
    colorCollectionId: string | null
    templateId: string | null
    leaderAgentId: string | null
    isArchived: 0
    agentCount: 0
    createdAt: number
    updatedAt: number
  }
}

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/teams \
  -H 'Content-Type: application/json' \
  -d '{"name":"Research Squad","icon":"🔬","color":"#34d399"}'

{
  name?: string
  icon?: string
  color?: string
  colorCollectionId?: string | null
  isArchived?: number          // truthy → 1, falsy → 0
  leaderAgentId?: string | null
}

{ "error": "team id required" }

{ "error": "invalid JSON" }

{ "error": "team not found" }

{
  team: {
    id: string
    name: string
    icon: string
    color: string
    colorCollectionId: string | null
    templateId: string | null
    leaderAgentId: string | null
    isArchived: number
    createdAt: number
    updatedAt: number
    agentCount: number
  }
}

{ "error": "<message>" }

curl -X PATCH http://localhost:18790/api/teams/<team-id> \
  -H 'Content-Type: application/json' \
  -d '{"name":"Renamed","leaderAgentId":"<agent-id>"}'

{ "error": "team id required" }

{ "ok": true }

{ "error": "<message>" }

curl -X DELETE http://localhost:18790/api/teams/<team-id>

{
  agentId: string     // required
  agentName?: string  // display name when creating a new row; defaults to agentId
}

{ "error": "team id required" }

{ "error": "agentId is required" }

{ "ok": true }

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/teams/<team-id>/agents \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"<agent-id>"}'

{ "error": "agentId required" }

{ "ok": true }

{ "error": "<message>" }

curl -X DELETE http://localhost:18790/api/teams/<team-id>/agents/<agent-id>

{ "error": "team id required" }

{
  agentsIntroduced: boolean // default false
  userIntroduced: boolean // default false
  userIntroText: string // default ''
}

{ "error": "<message>" }

curl http://localhost:18790/api/teams/<team-id>/onboarding

{
  agentsIntroduced?: boolean
  userIntroduced?: boolean
  userIntroText?: string   // sliced to 4000 chars server-side
}

{ "error": "team id required" }

{ "error": "invalid JSON" }

{
  agentsIntroduced: boolean
  userIntroduced: boolean
  userIntroText: string
}

{ "error": "<message>" }

curl -X PATCH http://localhost:18790/api/teams/<team-id>/onboarding \
  -H 'Content-Type: application/json' \
  -d '{"agentsIntroduced":true,"userIntroduced":true,"userIntroText":"I run a small SaaS."}'

{ "error": "team id required" }

{
  content: string | null // null = no brief, no board tasks, no saved memory, no meaningful chat
}

{ "error": "<message>" }

curl http://localhost:18790/api/teams/<team-id>/activity-summary

{
  message: string          // required; trimmed, must be non-empty
  targetAgentId?: string   // honored only when it matches a roster member
  entryId?: string         // client-minted id for the persisted user entry (SSE dedup)
}

{ "error": "team id required" }

{ "error": "message required" }

{ "error": "team is not server-orchestrated" }

{ "ok": true }

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/teams/<team-id>/chat \
  -H 'Content-Type: application/json' \
  -d '{"message":"Plan the launch checklist."}'

{ "error": "team id required" }

{ "error": "team is not server-orchestrated" }

{ "ok": true }

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/teams/<team-id>/chat/stop

Content-Type: text/event-stream; charset=utf-8
Cache-Control: no-cache, no-transform
Connection: keep-alive
X-Accel-Buffering: no

: connected

id: 8121
data: {"entryId":"...","role":"user","kind":"user","text":"Plan the launch checklist.","sessionKey":"agent:<id>:team:<team-id>","runId":null,"source":"local-send","timestampMs":1718450000000,"sequenceKey":1,"confirmed":true,"fingerprint":"..."}

event: status
data: {"agentId":"<agent-id>","status":"running"}

event: delta
data: {"sessionKey":"agent:<id>:team:<team-id>","runId":"<run-id>","text":"Here is the checklist so far"}

: keepalive

curl -N http://localhost:18790/api/teams/<team-id>/chat/stream

# Resume from a known transcript row id
curl -N 'http://localhost:18790/api/teams/<team-id>/chat/stream?since=8121'

{ "error": "team id required" }

{
  content: string
}

{ "error": "<message>" }

curl http://localhost:18790/api/team-rules/<team-id>

{ content?: string }   // required string; max 4000 chars

{ "error": "team id required" }

{ "error": "invalid JSON" }

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

{ "error": "content exceeds 4000 characters" }

{
  content: string
}

{ "error": "<message>" }

curl -X PUT http://localhost:18790/api/team-rules/<team-id> \
  -H 'Content-Type: application/json' \
  -d '{"content":"Always delegate via <delegate>; never do the work yourself."}'

{ "error": "teamId or roomId is required" }

{
  roomId: string
  posts: Array<{
    id: string
    roomId: string
    teamId: string
    authorAgentId: string
    body: string
    kind: 'peer' | 'system' | 'user' // 'peer' teammate post · 'system' board-mutation narration · 'user'
    createdAt: number
    seq: number // per-room monotonic
  }>
  nextSeq: number // the last post's seq, or the requested sinceSeq when empty
}

{ "error": "<message>" }

curl 'http://localhost:18790/api/team-chat?teamId=<team-id>&sinceSeq=0'

{
  teamId: string             // required
  stimulus?: string          // the initiating message for the first speaker's turn
  firstSpeakers?: string[]   // agent ids seeded to speak first; defaults to the leader
  maxExchangeTurns?: number  // clamped server-side to DEFAULT_MAX_EXCHANGE_TURNS (5) × participants
}

{ "error": "teamId is required" }

{ "ok": false, "error": "an exchange is already running for this room" }

{
  ok: true
  roomId: string
  result: {
    turnsTaken: number
    endedReason: 'max_turns' | 'no_pending_obligation' | 'budget_paused' | 'aborted'
    speakers: string[]   // ordered agent ids who spoke this exchange
  }
}

{ "ok": false, "error": "team not found" }

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

{ "error": "<message>" }

curl -X POST http://localhost:18790/api/team-chat/exchange \
  -H 'Content-Type: application/json' \
  -d '{"teamId":"<team-id>","stimulus":"Plan the launch checklist."}'