Submit one document
post/v1/intake/submit
Registers a single document for review and returns the new submission. Review checks the file type and size before accepting it; if either is not supported, the call returns 422 and nothing is created.
Access: Bearer token with role client_admin, platform_admin, or integrator_sandbox. About authentication
Parameters
| Parameter | In | Type | Details |
|---|---|---|---|
| tenant_idOptional | Query | string (uuid) | Only for platform_admin tokens acting for a client workspace. Leave it out otherwise. |
| Idempotency-KeyOptional | Header | string | Optional, 1–128 characters. Same key and body replays the stored 201; same key with a different body returns 409. Expires after 24 hours.1–128 characters |
Request body IntakeSubmitRequest
| Field | Type | Details |
|---|---|---|
| filenameRequired | string | File name as it should appear to your team and the reviewer.1–255 characters |
| file_sizeRequired | integer | File size in bytes. Up to 50 MB.greater than 0 |
| mime_typeRequired | string | One of application/pdf, Word (.docx), Excel (.xlsx), text/plain, text/html, text/xml, or application/xml.1–127 characters |
| moduleOptional | stringor null | Optional review module key: ai_output, content_risk, plain_language, or education_accessibility. Omit to use your workspace default; other values return 422 INTAKE_INVALID_MODULE.at most 40 characters |
| tierOptional | stringor null | Retired — omit this field. If sent, the API returns 422 INTAKE_TIER_RETIRED.at most 20 characters |
| external_referenceOptional | stringor null | Your own ID for this work, such as a ticket or job number. Returned on the submission so you can match it.at most 255 characters |
| item_metadataOptional | objector null | Optional JSON object you want stored with the item: up to 50 keys, 10 KB serialized, and 3 levels deep. |
Responses
| Status | Meaning | Body or error code |
|---|---|---|
| 201 | Successful Response | IntakeSubmissionResponse |
| 401 | Missing, expired, or invalid access token | APIErrorEnvelope |
| 403 | Token does not carry an accepted role | APIErrorEnvelope |
| 409 | Idempotency key mismatch or in progress | APIErrorEnvelope |
| 422 | Validation or intake field error | APIValidationErrorEnvelope |
| 429 | Intake rate limit exceeded | APIErrorEnvelope |
| 401 | Missing, expired, or invalid access token. | AUTH_REQUIRED |
| 403 | The token does not carry an accepted role. | INSUFFICIENT_ROLE |
| 422 | mime_type is not one of the supported types. | FILE_TYPE_NOT_ALLOWED |
| 422 | file_size is over 50 MB. | FILE_TOO_LARGE |
| 429 | Too many intake calls. Wait for Retry-After seconds, then retry. | RATE_LIMIT_EXCEEDED |
- Send an
Idempotency-Keyso a network retry cannot create a duplicate submission. - A successful call records an
intake.submittedaudit event and triggersintake.submittedwebhooks.
curl -sS -X POST "https://review.querytek.io/api/v1/intake/submit" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"filename": "employee-handbook-2027.pdf",
"file_size": 482113,
"mime_type": "application/pdf",
"external_reference": "hr-handbook-2027",
"item_metadata": {"department": "People Operations"}
}'