POST /test/export
Export Test
Artifact-level test export.
Dispatches on body.view to per-view exports and returns
\{file_id, file_name, row_count\}. Client downloads via
/api/test/download/\{file_id\} (BFF) → /test/file/download.
Request Body (ExportTestApiRequest)
| Field | Type | Required | Description |
|---|---|---|---|
view | string | No | View discriminator: ‘single' |
test_id | string | No | UUID of the target test (required for ‘single’ and ‘invocation’) |
invocation_id | string | No | UUID of the target invocation entry (optional for ‘invocation’) |
draft_id | string | No | Optional draft id for ‘invocation’ view |
mode | string | No | Optional sub-mode within a view. Currently recognized: view=reports → mode=‘brightspace’ (gradebook CSV only); view=home → mode=‘certificate’ (PDF cert only) or ‘attempts’ (CSV only). Default (None) returns the full per-view bundle. |
idempotency_key | string | No | Idempotency key — replays the prior export; on the ack, the server-minted soft key to activate/reject a staged export |
soft | boolean | No | Stage the export dormant (file chain active=False) — agent proposes; accept activates. Sim-env ‘dormant export’ primitive. |
accept | boolean | No | Ack: True activates the staged export, False rejects. Only meaningful with idempotency_key |
Response (ExportTestApiResponse)
| Field | Type | Required | Description |
|---|---|---|---|
file_id | string | Yes | UUID of the files_resource holding the export bytes |
file_name | string | Yes | Suggested download file name |
row_count | integer | Yes | Number of data rows in the export |
idempotency_key | string | No | Server-minted soft-call key (audit call_id). On a soft propose, echo this back with accept to activate/reject the staged export. |
Last updated on