Approvals and evaluations

Read execution approval and result review separately; only an authorized human can decide either gate. An evaluation is a distinct saved judgment and may trigger configured follow-up work, so submit one only when requested. Read the Runs guide for the workflow.

List approval requests

swarm_list_approval_requests

Read one bounded page of authorized approval requests.

Required: None
Optional: space_idresource_typeresource_idstatuslimitcursororder
Effect: read
Capability: space.read

Get approval request

swarm_get_approval_request

Read one authorized approval request.

Required: request_id
Optional: None
Effect: read
Capability: space.read

List Evaluations

swarm_list_evaluations

Read one bounded page of authorized Evaluations.

Required: None
Optional: space_idrun_idartifact_idevaluator_agent_idoutcomelimitcursororder
Effect: read
Capability: space.read

Get Evaluation

swarm_get_evaluation

Read one authorized Evaluation.

Required: evaluation_id
Optional: None
Effect: read
Capability: space.read

Submit evaluation

swarm_submit_evaluation

Record one bounded evaluation for a visible Run or Artifact. An active evaluation can trigger configured follow-up work; this does not resolve a human approval.

Required: summaryidempotency_key
Optional: space_idrun_idartifact_idoutcomescorerubric_keydimensionsconfidencesignalscontract_hash
Effect: additive
Capability: evaluation.create