Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.

Path Parameters

id
string
required

The agent's unique ID (the UUID returned by createAgent / listAgents).

Body

application/json
message
string
required

Plain-language instruction describing the change to make to this agent.

Response

SSE stream; terminal frame carries AssistResult.

reply
string
threadId
string

The thread this turn belongs to (persistent memory).

appliedMutations
object[]
pendingConfirmations
object[]

Destructive tool calls the copilot wants to run, held until the user confirms (re-send as confirmed).

connects
object[]

OAuth connect affordances the client renders as a button (never the raw consent URL in the reply prose).