CAcaveman

GET /projects/{projectId}/annotations

GET /api/v1/projects/{projectId}/annotations on the Caveman Cloud control plane. Requires the payload:read scope. Exposed to autonomous agents as the search action of the caveman_annotations tool (read access). Human judgements on traces and eval runs: review notes with a label, a note and an open or resolved status, searchable across the project. Notes can quote captured content, so reading them needs payload access.

get/projects/{projectId}/annotations

Request

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

Query parameters

qstring
labelstring
statusstring
kindstring
trace_idstring
idstring
fromstring date-time
tostring date-time
limitinteger
cursorstring

Response

Successful response. Exact status depends on synchronous or durable delivery outcome.

Changes

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