Skip to main content

Test Submission (Admin)

Run a partner submission in the cap-enforced sandbox. Requires Stage-1 lint to have passed via admin_validate_submission. Returns the full execution trace, final output, and duration. Admin-scoped API key required.

Parameters

NameTypeDefaultDescription
submissionId Requiredstring-
sampleInputs Requiredobject-
timeoutSecondsinteger60

Use Cases

  • Dry-run a partner workflow in the cap-enforced sandbox with sample inputs
  • Verify a workflow produces the expected output before requesting review
  • Capture an execution trace and final output for a submission (workflow-only; Stage-1 must have passed)

Example Usage

Run a workflow with sample inputs

{
"tool": "admin_test_submission",
"arguments": {
"submissionId": "3f7c2b1a-9d4e-4c2a-8b1f-0a1b2c3d4e5f",
"sampleInputs": {
"domain": "cisco.com"
},
"timeoutSeconds": 60
}
}

Response Format

FieldTypeDescription
statusstringSandbox run outcome. denied covers Phoenix-side refusals (Stage-1 not passed, unknown sample keys, render errors).
tracearrayOrdered execution trace entries (LLM turns, tool calls/results, logs).
trace[].kindstring
trace[].tsstring
trace[].dataobject
finalOutputstringFinal rendered output of the workflow (present on success).
durationMsnumberWall-clock duration of the run in milliseconds.
errorobjectPresent on failed/timed_out/denied runs.
error.codestring
error.messagestring