Company logoTrust Center Documentation
API v1 ReferenceDocumentsIdFile

Upload document file

Upload a file to associate with a document. Supports two upload methods:

  1. Multipart form-data with file field
  2. Binary stream with X-Original-Filename header

File validation includes size limits (10MB), MIME type checking, and automatic type detection from file signatures.

PUT
/api/v1/documents/{id}/file

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Document ID to upload file for

Formatuuid

Header Parameters

X-Original-Filename?string

Original filename (required for binary uploads)

file*file

File to upload. Supports various document and image formats (e.g., PDF, DOCX, PNG, JPG).

Formatbinary

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://app.orbiqhq.com/api/v1/documents/550e8400-e29b-41d4-a716-446655440000/file" \  -H "X-Original-Filename: privacy-policy.pdf" \  -F file="string"
{
  "success": true,
  "data": {
    "fileId": "file-789",
    "url": "https://directus.example.com/assets/file-789"
  }
}

{
  "error": "document_too_large",
  "details": "File size exceeds 10MB limit"
}

Empty
Empty
{
  "error": "unsupported_media_type"
}
{
  "error": "file_upload_failed_generic"
}

How is this guide?