PostMantis
API ReferenceUploads

Finalize an upload

Verifies the uploaded object, promotes it to a verified artifact, and returns the artifact id and a temporary read URL. Use the artifact id in post media references.

POST
/api/v1/uploads/complete

Verifies the uploaded object, promotes it to a verified artifact, and returns the artifact id and a temporary read URL. Use the artifact id in post media references.

Authorization

BearerAuth
AuthorizationBearer <token>

PostMantis API key from the dashboard. Include as Authorization: Bearer <key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

artifactId*string

Reserved artifact id returned by POST /api/v1/uploads. Must reference an upload whose bytes have been PUT to uploadUrl.

Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/api/v1/uploads/complete" \  -H "Content-Type: application/json" \  -d '{    "artifactId": "b2c3d4e5-f6a7-8901-bcde-f23456789012"  }'
{  "data": {    "artifactId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",    "storageKey": "user-123/...",    "url": "https://cdn.example.com/...",    "createdAt": "2026-05-05T10:00:00.000Z",    "kind": "video",    "mimeType": "video/mp4",    "sizeBytes": 12345678  }}

Request an upload URL POST

Starts a two-phase upload. Returns reserved artifact id and presigned PUT URL. Caller uploads bytes directly to storage, then calls `POST /uploads/complete` with artifact id. Max file size is 150 MB.

List publishing log entries GET

Returns chronological delivery status history (pending, published, failed, canceled). Pending means accepted and waiting for dispatch or scheduled time.