CAcaveman

POST /projects/{projectId}/scenario-suites/{suiteId}/runs

POST /api/v1/projects/{projectId}/scenario-suites/{suiteId}/runs on the Caveman Cloud control plane. Requires the experiment:run scope. Exposed to autonomous agents as the post_scenario_projects_projectid_scenario_suites_suiteid_runs action of the caveman_evals_write tool (write access). Author versioned datasets, reusable evaluators and workbenches; create strict suites, ingest evidence, and run baselines. Evidence ingest supports dry_run — always dry-run first. Ask Caveman to draft quality criteria again within the drafting allowance, propose a criterion for a person to turn on, and hold the pull request that adds the Caveman check to CI. Track a criterion on a slice of traces in one step: from an agent it lands proposed, and a person turns it on. Queue units for review and label them (an agent's label is recorded as an agent's, never as human gold), and make a dataset from recorded traffic.

post/projects/{projectId}/scenario-suites/{suiteId}/runs

Request

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

Request body

revisioninteger required
split'optimization' | 'holdout' required

Response

Tenant-scoped simulation evidence

idstring required
suite_idstring required
suite_revisioninteger required
document_sha256string required
engine_versionstring required
split'optimization' | 'holdout' required
status'queued' | 'running' | 'completed' | 'cancelled' | 'interrupted' | 'error' required
summaryobject required
gateunknown required
created_atstring date-time required
evidence_basis'simulation' required

Changes

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