Send a message and wait for the full reply — Runs one turn on a session you own and returns the complete result as JSON once the turn finishes…

Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

Runs one turn on a session you own and returns the complete result as JSON once the turn finishes, instead of streaming. Use it when you cannot consume Server-Sent Events.

The response has the same shape as the batch form of the execute operation: every event produced during the turn, plus the final session state. Long turns hold the request open until they complete.

clientIdstring

Client identifier for version vector tracking. Generated when omitted.

diagnosticsany

Optional opt-in to include a per-turn diagnostic report in the result.

Responses

`200` OK

Turn finished

Response shape:

successboolean

eventsobject[]

stateobject

Full session state snapshot persisted in Supabase

curl -X POST 'https://ivybiosciences.com/api/v1/sessions/{sessionId}/messages/sync' \
  -H "Authorization: Bearer $IVY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "content": ""
}'

POST /v1/sessions/{sessionId}/messages/sync

Request

Path parameters

Request body

Responses

`200` OK

`400` Bad Request

`401` Unauthorized

`404` Not Found

`429` Too Many Requests

`500` Internal Server Error