The code session record object

⚠️

Preview — this feature is being built; the design below is the spec.

The code_session_record object as the API returns it. Every field below appears in every response that returns this object; fields with no value are null rather than missing.

Example

{
  "id": "csess_01JCY0Y2A4C6E8G0J2L4",
  "type": "code_session_record",
  "user_id": "user_01J9Y0A2C4E6G8J0L2N4",
  "client": "syntic-code-cli 1.8.0",
  "repository": "git.example.com/acme/billing-service",
  "branch": "fix/rounding",
  "model": "Syntic Code",
  "turns": 31,
  "tool_calls": 88,
  "files_changed": 7,
  "started_at": "2026-11-04T13:00:00Z",
  "ended_at": "2026-11-04T14:12:00Z",
  "transcript_available": true,
  "transcript": [
    {
      "role": "user",
      "at": "2026-11-04T13:00:05Z",
      "text": "Invoices round half-down; fix it to round half-even and add tests."
    },
    {
      "role": "tool",
      "at": "2026-11-04T13:01:10Z",
      "tool": "shell",
      "input": "cargo test -p billing",
      "exit_code": 101
    },
    {
      "role": "tool",
      "at": "2026-11-04T13:04:02Z",
      "tool": "edit",
      "path": "src/money.rs",
      "accepted": true
    }
  ]
}

Fields

Field	Type	Description
`id`	string	Unique id of this object.
`type`	string	The object type, always `code_session_record`.
`user_id`	string	The member concerned.
`client`	string	See the endpoint pages below.
`repository`	string	See the endpoint pages below.
`branch`	string	See the endpoint pages below.
`model`	string	Model id.
`turns`	integer	See the endpoint pages below.
`tool_calls`	integer	See the endpoint pages below.
`files_changed`	integer	See the endpoint pages below.
`started_at`	string	When work began.
`ended_at`	string	See the endpoint pages below.
`transcript_available`	boolean	`false` when transcripts are not retained or already expired.
`transcript`	array	Nested detail; see the endpoint pages below.

Returned by

chat_record compliance_export

Was this page helpful?