The session resource object

⚠️

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

The session_resource 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": "sres_01JCB2E4G6J8L0N2Q4S6",
  "type": "session_resource",
  "session_id": "sesn_01JC7M2K4P6R8T0V2X4Z",
  "kind": "git_repository",
  "git": {
    "url": "https://git.example.com/acme/billing-service.git",
    "ref": "main",
    "commit": "4f1c2a9",
    "vault_secret": "git-read-token"
  },
  "mount_path": "/workspace/repo",
  "read_only": false,
  "status": "mounted",
  "error": null,
  "created_at": "2026-11-05T10:01:10Z",
  "updated_at": "2026-11-05T10:01:31Z"
}

Fields

Field	Type	Description
`id`	string	Starts with `sres_`.
`type`	string	The object type, always `session_resource`.
`session_id`	string	The related session.
`kind`	string	`file`, `git_repository` or `memory_store`.
`git`	object	For `kind: git_repository`: `url`, `ref`, the resolved `commit`, and the vault secret used to clone.
`mount_path`	string	Absolute path under `/workspace` inside the session’s environment.
`read_only`	boolean	Read-only mounts reject writes from the agent’s tools.
`status`	string	`pending`, `mounted`, `failed` or `removed`.
`error`	object or null	Why mounting failed: `code` and `message`.
`created_at`	string	When it was created, RFC 3339 UTC (some older objects use Unix seconds).
`updated_at`	string	When it last changed.

Returned by

session session_thread

Was this page helpful?