Docs
API ReferenceReferenceAgents

Run test cases against the draft

POST
/agents/{agentId}/tests

Runs up to 10 test cases against the DRAFT and grades each with the quality judge, using the agent's rubric when it has one and each case's expectedBehavior otherwise. Spends the organization's credits. Requires the agents:write scope and the quality checker on the organization's plan (feature_not_available otherwise).

AuthorizationBearer <token>

An organization API key, created from a Portal's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).

In: header

Path Parameters

agentId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/tests" \  -H "Content-Type: application/json" \  -d '{    "cases": [      {        "input": "string"      }    ]  }'
{  "tool": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "kind": "string",    "name": "string"  },  "summary": {    "total": 0,    "passed": 0,    "failed": 0  },  "results": [    {      "caseId": "string",      "input": "string",      "passed": true,      "output": "string",      "failures": [        {          "criterionId": "string",          "reason": "string",          "correctionHint": "string",          "targetNodeIds": [            "string"          ]        }      ],      "error": "string",      "executionId": "string",      "latencyMs": 0    }  ],  "corrections": [    {      "criterionId": "string",      "testCaseId": "string",      "reason": "string",      "correctionHint": "string",      "targetNodeId": "string",      "suggestedAction": "string"    }  ]}