Run the provided Pi harness

POST/v1/sessions/{id}/agent

Run one fresh Pi conversation against this session. Omitting provider and model uses the configured service default; supply both to override it. The service must have credentials for the selected provider. The request reserves the session until it finishes. Streams AgentEvent records as NDJSON. Agent history and events are not persisted for replay. Disconnect requests cancellation; requests have a 15-minute deadline.

Authorization

bearerAuth

AuthorizationBearer <token>

Use the owner-scoped product API key provided by the service operator.

In: header

Path Parameters

id*string

Session ID returned by open or list.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Uses the service default model when provider and model are omitted. Supply both fields together to override the default.

message?string

Length1 <= length <= 64000

provider*string

Length1 <= length <= 80

model*string

Length1 <= length <= 160

Response Body

`application/x-ndjson`

`application/json`

Request

curl -X POST "https://assemble-vms-api.fly.dev/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent" \  -H "Authorization: Bearer ${ASSEMBLE_API_KEY}" \  -H "Content-Type: application/json" \  -d '{    "message": "Write a short project plan to plan.md, then read it back."  }'

Response

"{\"type\":\"text\",\"delta\":\"I will inspect the session.\"}\n{\"type\":\"tool_start\",\"tool\":\"read\"}\n{\"type\":\"tool_end\",\"tool\":\"read\",\"isError\":false}\n{\"type\":\"done\"}\n"