CAcaveman

GET /projects/{projectId}/briefs

GET /api/v1/projects/{projectId}/briefs on the Caveman Cloud control plane. Requires the trace:read_metadata scope. Exposed to autonomous agents as the list action of the caveman_briefs tool (read access). The Improvements workspace: one written brief per finding worth a look, with its citations, charts, activity, revisions and comments. A brief's impact is the scout's estimate; once a proof is done, its proof (proof_summary on a list row) is the replayed result, always inferred, and the figure to quote.

get/projects/{projectId}/briefs

Request

  • Base URL
    https://api.caveman.so/api/v1
  • URL
    https://api.caveman.so/api/v1/projects/{projectId}/briefs
  • 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

statusstring
scoutstring
prioritystring
assigneestring
qstring
cursorstring
limitinteger

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.