RedRavenApi reference

Submit an attack-run turn

Upload the target request, response, and full `messages[]` for the pending turn. Warm-up turns return `decision: continue`. Attack turns return `decision: pending`; poll eval-status before calling next.

POST
/tests/{test_id}/attack-run/turns

Upload the target request, response, and full messages[] for the pending turn.

Warm-up turns return decision: continue. Attack turns return decision: pending; poll eval-status before calling next.

Authorization

ApiKeyAuth OrganizationId
X-API-Key<token>

Your RedRaven API key.

In: header

X-Organization-Id<token>

RedRaven organization UUID that scopes the API key.

In: header

Path Parameters

test_id*string

RedRaven test UUID.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/tests/497f6eca-6276-4993-bfeb-53cbbbba6f08/attack-run/turns" \  -H "Content-Type: application/json" \  -d '{    "run_id": "string",    "attempt_id": "string",    "request": "string",    "response": "string"  }'
{  "run_id": "string",  "attempt_id": "string",  "phase": "string",  "turn_index": 0,  "decision": "continue",  "evaluation": {},  "job_id": "string",  "done": true}
Empty

Get next attack prompt GET

Return the next user prompt and prior `messages` array, or `done` true when the run is finished. Returns 409 while an attack eval is still pending.

Get attack-run eval status GET

Poll until `decision` is `continue`, `stop`, or `exhausted`. `pending` means the eval worker has not finished.