---
title: "Create a submission"
method: POST
path: "/v2/submission"
---

# Create a submission

`POST /v2/submission`

Create a new submission for a document to be analyzed

## Request body

- SubmissionRequest
  - `query_id` string, nullable — User-defined ID of analyzed file - typically refers to internal ID of the analyzed document in user's CMS. Please ensure the query_id of any document is reviewed prior to submitting to ensure no PII is shared. Query_id is used for subsequent indexing of outputs from the document forensics analysis.
  - `pipeline_configuration` 'FRAUD_ONLY' | 'CLASSIFICATION_ONLY' | 'QUALITY_ONLY' — Type of analysis pipeline to execute.
  - `enable_decision` boolean — `true` to enable Adaptive Decision for the submitted document, `false` to disable it
  - `enable_submission_characteristics` boolean — `true` to enable attachment of submission characteristics for the submitted document, `false` to disable it (see `submission_characteristics_upload_url` field in the response object)

## Response `200`

Submission created successfully

- SubmissionResponse
  - `upload_url` string, uri, required — Presigned URL to AWS S3 service where the actual file will be uploaded using the PUT method. Note that the content type in the PUT request has to be set to `application/octet-stream`. Example file upload request using `curl`: ``` curl --request PUT \ --url $UPLOAD_URL \ --header 'content-type: application/octet-stream' \ --data @path_to_file ```
  - `submission_id` string, required — Unique submission ID generated by Documents service that uniquely identifies the submitted file.
  - `submission_characteristics_upload_url` string, uri — URL where submission characteristics can be attached to this submission - see the `/v2/submission/{submission_id}/characteristics` endpoint. Note that this URL is not pre-signed and requires access token in headers. The URL may be relative.

## Other responses

- `400` — Bad request.
- `401` — Missing valid authentication credentials.
- `403` — Access to the requested resource is forbidden.
- `404` — The requested resource was not found.
- `415` — Unsupported media type.
- `429` — Request quota was exceeded

---

[API](https://skmtc.dev/resistant/apis/resistant-documents-api.md) · [All operations](https://skmtc.dev/resistant/apis/resistant-documents-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resistant/resistant-documents-api/revisions/7c1ce5331e7b/schema)