POST /projects/{projectId}/eval-datasets/{datasetId}/versions
POST /api/v1/projects/{projectId}/eval-datasets/{datasetId}/versions on the Caveman Cloud control plane. Requires the eval:write scope. Exposed to autonomous agents as the snapshot_dataset 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.
Request
- Base URLhttps://api.caveman.so/api/v1
- URLhttps://api.caveman.so/api/v1/projects/{projectId}/eval-datasets/{datasetId}/versions
- Auth
- OAuth 2Authorization code: /api/v1/oauth/authorizeToken URL: /api/v1/oauth/token scopes: eval:write
- or HTTP bearer
- or API key in cookie cave_access
- or API key in cookie __Secure-cave_identity.session_token
Request body
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.