Skip to main content
POST
Queue an asynchronous run with optional draft configuration. Select 1 to 200 effective cases. With no selectors, all active cases for the agent are selected, subject to the limit. Every case needs criteria. Group runs evaluate only the selected group’s checks. Runs use recorded or mock Action responses and never call live Actions; selected drafts are not published. Queue failures return 503.

Headers

string
required
Bearer token containing your workspace API key. The key needs write scope.

Body parameters

string
required
Agent UUID. The agent must belong to the workspace.
array
Up to 200 case UUIDs. Omit to select cases through the other selectors.
array
Up to 200 collection UUIDs. Their direct and group-linked cases are included.
string
Run only this group’s shared criteria. Cannot be combined with nonempty folderIds.
string
Collection UUID for selection/origin. Every selected case must belong to it. A group must be linked to that collection.
string
Behavior version UUID for this agent. Omit to use the current published version.
array
Up to 100 unique draft rule-version UUIDs. Select at most one draft per rule.
array
Up to 100 unique draft article UUIDs available to this agent. Select at most one draft per original article.

Response

Returns the run with queued case items and 202 Accepted. New runs intentionally have an empty array of collection origins.