Skip to main content
POST
Error

Autorizações

Authorization
string
header
obrigatório

A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange. Only a 401 means it is spent; not_a_member (403) is about the organization named in X-Organization-Id and leaves the token good for the others.

Cabeçalhos

X-Organization-Id
string

The organization the caller is acting on — the org_… code that appears in the panel URL. It identifies; the membership JOIN is what authorizes, so a forged code reads nothing: the answer is not_a_member (403), which does not mean the session is over. Absent, the session's default organization answers, or — if that membership was revoked while the session was open — any other one the caller still holds.

Corpo

application/json
content_type
enum<string>
obrigatório
Opções disponíveis:
image/jpeg,
image/png,
image/webp,
image/gif
size_bytes
integer
obrigatório

Up to 5 MiB.

Intervalo obrigatório: 1 <= x <= 5242880

Resposta

The presigned upload.

Everything the browser needs to PUT the file straight into the bucket, and everything the caller needs to reference it afterwards.

upload_url
string
headers
object

Send these with the PUT — they are part of the signature.

public_url
string

Where the object will be readable. Save this on the profile or the organization.