CAcaveman

GET /projects/{projectId}/agent-runs

GET /api/v1/projects/{projectId}/agent-runs on the Caveman Cloud control plane. Requires the trace:read_metadata scope. Not exposed to autonomous agents: Native user history of immutable owned chat runs. Shared agents use the protected journal. Native unscoped user endpoint. Returns only this user's owned chat run metadata. Results require separate current permission and source checks.

get/projects/{projectId}/agent-runs

Request

  • Base URL
    https://api.caveman.so/api/v1
  • URL
    https://api.caveman.so/api/v1/projects/{projectId}/agent-runs
  • Auth
    • OAuth 2
      Authorization code: /api/v1/oauth/authorize
      Token URL: /api/v1/oauth/token scopes: trace:read_metadata
    • or HTTP bearer
    • or API key in cookie cave_access
    • or API key in cookie __Secure-cave_identity.session_token

Query parameters

afterstring uuid

Previous next_cursor. Omit for first page.

sessionsboolean

Return the newest owned chat run per case, ordered by latest activity.

Response

Bounded native user page.

next_cursorstring required

Run UUID cursor, or empty when no next page.

Changes

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