Skip to main content
POST
Init Upload

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) — sent as Authorization: Bearer <key>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08

Body

application/json
file_name
string
required
mime_type
string
required
embed
boolean
default:true
metadata
Metadata · object

Response

Successful Response

file_id
string
required
signed_url
string
required
expires_at
string<date-time>
required
required_headers
Required Headers · object
max_size_bytes
integer
default:31457280