Sessions

Append Turn

Changed on
post/sessions/turns/

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/sessions/turns/
  • Auth
    API key in header Authorization

Request body

session_idstring required
turn_idstring uuid nullable
stream_idstring uuid required
turn_indexinteger required
harness_kind'pi_core' | 'claude' | 'codex' | 'mock' required

The coding agent program a run drives. A backend declares which it supports.

pi_core is Pi; claude drives Claude Code; codex drives Codex. mock drives no real coding agent at all: it is a deterministic, LLM-free, network-free stand-in for testing, selecting a named behavior the runner resolves in-process.

agent_session_idstring nullable
sandbox_idstring nullable
trace_idstring uuid nullable
span_idstring nullable
start_timestring date-time nullable
end_timestring date-time nullable

Response

Successful Response

countinteger

Changes

  • 7adb3c40354eRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • a28f1d059149Revision changes
    • warning

      added the new mock enum value to the // response property for the response status

    • info

      added the new mock enum value to the request property