Submissions

POST /api/v3/submissions

Changed on

Creates a private draft. Replays return the original 201 body and resource URL. Omitted processing is detect-and-identify. The replayed body/ETag may be old: GET the resource before any mutation.

Request

Headers

Idempotency-Keystring required

Scoped to context, authenticated principal and operation. Same input replays the original response; changed input is 409.

Request body

contractVersion'1' required

Response

Success

idstring uuid required
contractVersion'1' required
revisioninteger required
state'draft' | 'validated' | 'queued' | 'importing' | 'imported' | 'failed' | 'needs_reconciliation' | 'cancelled' | 'expired' required
createdAtstring date-time required
expiresAtstring date-time required
importTaskIdstring uuid
validationIdstring uuid
rowsDigeststring

Server-generated informational SHA-256 digest. Clients reconcile by GET rows and JSON value equality, not by reproducing this digest.

rowCountinteger required

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • warning

      added the new detect-and-identify enum value to the / response property for the response status

    • warning

      added the new dispatched enum value to the / response property for the response status

    • warning

      added the new dispatching enum value to the / response property for the response status

    • warning

      added the new not_started enum value to the / response property for the response status

    • info

      the request property default value changed from import-only to detect-and-identify

    • info

      added the new detect-and-identify enum value to the request property /

    • info

      the response's property default value changed from import-only to detect-and-identify for the status