Skip to main content
POST
Post a chat message to a fleet

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

workspace_id
string
required

UUIDv7 of the workspace.

fleet_id
string
required

UUIDv7 of the fleet.

Body

application/json

POST /v1/workspaces/{ws}/fleets/{id}/messages — an operator's steer.

One field, and unknown ones are ignored rather than refused, which is what parseFromSlice(.{ .ignore_unknown_fields = true }) does. A client sending a field this build does not read is not making a mistake it needs telling about.

message
string
required

What to say to the fleet.

Bounded on the decoded bytes, which is what reaches the stream. The escaped form a client sends is not what counts against the limit.

Response

Accepted for publication; a subscriber reading it is a separate event

What a steer returns once agentsfleet accepts the request.

The response carries the id the run is found under. Filter the live event tail on event_id to follow the message you just sent.

event_id
string
required

The canonical event id the steer became.

status
string
required

Always accepted. A field rather than an implied 202, because that is what the daemon this ports writes.