Durably admit a manual or preview-only test request

POST/api/v1/workspaces/{workspace_id}/agents/studio/definitions/{definition_id}/requests

Test is the only preview-only source kind. Each request pins the current definition revision and charges actual settled compute.

Path Parameters

workspace_idRequired

string <uuid>

Example0198ac5e-f9b7-7000-8000-000000000001

definition_idRequired

string <uuid>

Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

X-CSRF-TokenRequired

string·min 43·max 43

Session-bound CSRF token. It must exactly match the __Host-assign_csrf cookie sent with the request.

Idempotency-KeyRequired

string·min 16·max 200

Opaque client-generated key for safely retrying this operation.

Request Body

application/json

source_kindRequired

string

Values

manualtestmentiondelegationevent

source_idRequired

string <uuid>

Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.

Example0198ac5e-f9b7-7000-8000-000000000001

task_id

string <uuid>

Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.

Example0198ac5e-f9b7-7000-8000-000000000001

instructionsRequired

string·max 2000

Original bounded request input for its requester and Studio managers; returned as an empty string in member-visible history.

preview_onlyRequired

boolean

Must be true exactly when source_kind is test.

Responses

Authentication · Conventions and errors · API guides · Resource reference

Durably admit a manual or preview-only test request