Push user input into a session and run one turn. The blocking endpoint performs recall → model → tools → persist, then returns a single turn object.
Endpoint
Authentication
Authorization: Bearer <api_key> or Authorization: ApiKey <key>. Optional if AGENT_CLOUD_API_KEY is unset.
Path parameters
Request body
Provide text via input or structured content parts. Empty input returns 400.
Plain-text user input (short form).
OpenAI-shaped parts, for example [{"type":"input_text","text":"..."}].
Optional type tag; defaults to treating the body as a message.
Response
Returns a agent.session.turn object:
Always agent.session.turn.
Typically completed (or failed / cancelled / in_progress).
Assistant output text when completed.
Epoch milliseconds when finished.