a13nDocs
API referenceAssets

Create Upload

Repeating a request with the same `Idempotency-Key` and bytes returns the same upload.

POST/api/v1/uploads

Repeating a request with the same Idempotency-Key and bytes returns the same upload.

Authorization

AuthorizationBearer <token>

A workspace API key (a13n_...)

In: header

Header Parameters

Idempotency-Key*Idempotency-Key
Match^[!-~]+$
Length1 <= length <= 512
X-Workspace-ID?|

The workspace ID a login session acts in; required with a login session. An API key acts in its own workspace and needs none; naming another is forbidden.

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

The multipart form: one file part named file.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/uploads" \  -H "Idempotency-Key: string" \  -F file="string"
{  "content_type": "string",  "digest": "string",  "filename": "string",  "size": 0,  "upload_id": "string"}