Get a Session

Retrieves one CMA-shaped Session. The response contains the resolved Agent Version snapshot, Environment ID, Resources, Vault IDs, budget, metadata, title, lifecycle status, timestamps, usage, statistics, and outcome evaluations. Checkfu adds only optional automation_id, the bounded Deployment-to-Automation terminology substitution. An id outside the authenticated Workspace answers not-found.

Checkfu support posture: alpha; hosted. Required evidence journey: session-turn. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.

GET /v1/sessions/{session_id}

Get a Session

cURL

curl --request GET \
  --url https://api.checkfu.com/v1/sessions/{session_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'checkfu-beta: <checkfu-beta>' \
  --header 'checkfu-version: <checkfu-version>'

200

{
  "id": "<string>",
  "agent": {
    "id": "<string>",
    "description": "<string>",
    "mcp_servers": [
      {
        "type": "url",
        "name": "<string>",
        "url": "<string>"
      }
    ],
    "model": {
      "id": "<string>",
      "effort": {
        "type": "low"
      },
      "inference_geo": "global",
      "speed": "standard"
    },
    "name": "<string>",
    "skills": [
      {
        "type": "anthropic",
        "skill_id": "<string>",
        "version": "<string>"
      }
    ],
    "system": "<string>",
    "tools": [
      {
        "type": "agent_toolset_20260401",
        "configs": [
          {
            "name": "bash",
            "type": "bash",
            "enabled": true,
            "permission_policy": {
              "type": "always_allow"
            }
          }
        ],
        "default_config": {
          "enabled": true,
          "permission_policy": {
            "type": "always_allow"
          }
        }
      }
    ],
    "multiagent": {
      "agents": [
        {
          "id": "<string>",
          "description": "<string>",
          "mcp_servers": [
            {
              "type": "url",
              "name": "<string>",
              "url": "<string>"
            }
          ],
          "model": {
            "id": "<string>",
            "effort": {
              "type": "low"
            },
            "inference_geo": "global",
            "speed": "standard"
          },
          "name": "<string>",
          "skills": [
            {
              "type": "anthropic",
              "skill_id": "<string>",
              "version": "<string>"
            }
          ],
          "system": "<string>",
          "tools": [
            {
              "type": "agent_toolset_20260401",
              "configs": [
                {
                  "name": "bash",
                  "type": "bash",
                  "enabled": true,
                  "permission_policy": {
                    "type": "always_allow"
                  }
                }
              ],
              "default_config": {
                "enabled": true,
                "permission_policy": {
                  "type": "always_allow"
                }
              }
            }
          ],
          "type": "agent",
          "version": 1
        }
      ],
      "type": "coordinator"
    },
    "type": "agent",
    "version": 1
  },
  "archived_at": "<string>",
  "budget": {
    "type": "limit",
    "max_list_cost": {
      "amount": "<string>",
      "currency": "USD"
    }
  },
  "created_at": "<string>",
  "environment_id": "<string>",
  "metadata": {},
  "outcome_evaluations": [
    {
      "completed_at": "<string>",
      "description": "<string>",
      "explanation": "<string>",
      "iteration": 1,
      "outcome_id": "<string>",
      "result": "<string>",
      "type": "outcome_evaluation"
    }
  ],
  "resources": [
    {
      "id": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "mount_path": "<string>",
      "type": "github_repository",
      "url": "<string>",
      "checkout": {
        "type": "branch",
        "name": "<string>"
      }
    }
  ],
  "stats": {
    "active_seconds": 1,
    "duration_seconds": 1
  },
  "status": "rescheduling",
  "title": "<string>",
  "type": "session",
  "updated_at": "<string>",
  "usage": {
    "active_seconds": 1,
    "cache_creation": {
      "ephemeral_1h_input_tokens": 1,
      "ephemeral_5m_input_tokens": 1
    },
    "cache_read_input_tokens": 1,
    "input_tokens": 1,
    "list_cost": {
      "amount": "<string>",
      "currency": "USD"
    },
    "output_tokens": 1,
    "server_tool_use": {
      "web_fetch_requests": 1,
      "web_search_requests": 1
    }
  },
  "vault_ids": [
    "<string>"
  ],
  "automation_id": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version · enum<string> · required

Available options: 2026-08-29

checkfu-beta · string · required

Path Parameters

session_id · string · required

Pattern: ^sess_[0-9a-f]{32}$

Response

200

application/json

BetaManagedAgentsSession

id · string · required

Pattern: ^sess_[0-9a-f]{32}$

agent · object · required

Show child attributes

archived_at · string | null · required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

budget · object | null · required

Show child attributes

created_at · string · required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

environment_id · string · required

Pattern: ^env_[0-9a-f]{32}$

metadata · object · required

at most 16 correlation pairs with keys of 1 to 64 characters

Show child attributes

outcome_evaluations · object[] · required

Show child attributes

resources · object[] · required

Option 1

Option 2

Option 3

Show child attributes

stats · object · required

Show child attributes

status · enum<string> · required

Available options: rescheduling, running, idle, terminated

title · string | null · required

type · enum<string> · required

Available options: session

updated_at · string · required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

usage · object · required

Show child attributes

vault_ids · string[] · required

Pattern: ^vlt_[0-9a-f]{32}$

automation_id · string | null

Pattern: ^auto_[0-9a-f]{32}$