Skip to main content
POST
Upload a file for a reusable handle

Authorizations

Authorization
string
header
required

Authorization: Bearer hmok_... API key or a dashboard session token

Headers

Idempotency-Key
string

Optional. Send the same key when retrying the same request: a completed request is replayed (same status and body, Idempotent-Replayed: true) instead of running twice. Keys are scoped to your organization for 24 hours. 409 IDEMPOTENCY_KEY_REUSED: the key was used for a different request. 409 IDEMPOTENCY_IN_PROGRESS: the first request is still running. 409 IDEMPOTENCY_OUTCOME_UNKNOWN: the first attempt may have reached the channel; check it before retrying with a new key. Without the header, delivery is at-least-once.

Pattern: ^[\x21-\x7E]{1,255}$

Path Parameters

ch
string
required

ch_ channel id

Body

file
file
required

JPEG or PNG up to 5 MB, MP4 up to 16 MB, PDF up to 29 MB

Response

Uploaded

channelId
string
required
handle
string
required

Use as profilePictureHandle or a template header_handle

mimeType
string
required
sizeBytes
integer
required