Upload a file for a reusable handle
Uploads a file and returns a handle to use as the profile photo (profilePictureHandle on the
profile update) or as a template media header (header_handle). Send either
multipart/form-data with exactly one part, a file named file, or JSON with a public https
sourceUrl. JPEG and PNG up to 5 MB, MP4 up to 16 MB, PDF up to 29 MB. The profile photo must
be a JPEG or PNG.
Authorizations
Headers
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.
^[\x21-\x7E]{1,255}$