CAcaveman

Create experiment

POST /api/v1/experiments on the Caveman Cloud control plane. Requires the experiment:run scope. Exposed to autonomous agents as the create action of the caveman_experiments_write tool (write access). Create, start and cancel experiments. Approving an S3 experiment and rolling one back stay human-only.

post/experiments

Request

  • Base URL
    https://api.caveman.so/api/v1
  • URL
    https://api.caveman.so/api/v1/experiments
  • 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

baseline_configunknown
candidate_configunknown
eval_suite_idstring
guardrailsunknown
namestring
opportunity_idstring
practice_idstring
type'replay' | 'shadow' | 'canary' | 'density-canary' | 'before_after'

Response

Experiment created

Changes

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