CAcaveman

List Caveman Code sessions

GET /api/v1/code/sessions on the Caveman Cloud control plane. Requires the code:read scope. Not exposed to autonomous agents: Caveman Code's registry is driven by the Code app and the runtimes it enrolls. An agent works inside a Code session and reaches its tree through the session mailbox, never by listing, starting or archiving workspaces or enrolling runtimes from a control-plane connection.

get/code/sessions

Request

  • Base URL
    https://api.caveman.so/api/v1
  • URL
    https://api.caveman.so/api/v1/code/sessions
  • Auth
    • OAuth 2
      Authorization code: /api/v1/oauth/authorize
      Token URL: /api/v1/oauth/token scopes: code:read
    • or HTTP bearer
    • or API key in cookie cave_access
    • or API key in cookie __Secure-cave_identity.session_token

Query parameters

workspace_idstring uuid

Only this workspace's sessions.

origin'person' | 'api' | 'automation'

Only sessions of this origin.

agent_idstring uuid

Only sessions running this agent.

Response

Sessions, newest first

Changes

No recorded changes to this operation across all 1 revision of this API.