POST
/filesUpload a file
Requires Bearer authentication. See Authentication.
Request body
| Field | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sourcerequired | FileSource | — | ||||||||||||
kind = s3
kind = gcs
| ||||||||||||||
fileTyperequired | string | — | ||||||||||||
customerExternalIdrequired | string | — | ||||||||||||
contentType | string | — | ||||||||||||
sizeBytes | integer | string | — | ||||||||||||
Option 1 · integer No fields. Option 2 · string No fields. | ||||||||||||||
fileName | string | — | ||||||||||||
metadata | object (record) | — | ||||||||||||
idempotencyKey | string | — | ||||||||||||
correlationId | string | — | ||||||||||||
requestId | string | — | ||||||||||||
Responses
202 202| Field | Type | Description |
|---|---|---|
idrequired | string (uuid) | — |
statusrequired | "accepted" | "duplicate" | — |
matchedDestinationsrequired | integer | — |
400 400| Field | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | — | |||||||||
| |||||||||||
401 401| Field | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | — | |||||||||
| |||||||||||
403 403| Field | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | — | |||||||||
| |||||||||||
413 413| Field | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | — | |||||||||
| |||||||||||
Errors
Errors use the standard envelope. See Errors for codes, status mappings, and retry semantics.