Skip to main content
POST
Create a private visual upload grant

Authorizations

Authorization
string
header
required

Use the raw API key as the Bearer token, or send X-API-Key instead.

Body

application/json
purpose
enum<string>
required
Available options:
face,
palm_left,
palm_right
content_type
enum<string>
required
Available options:
image/jpeg,
image/png,
image/webp
content_length
integer
required
Required range: 1 <= x <= 12582912
sha256
string
required

64-character hex or canonical base64 SHA-256.

Response

Signed PUT grant.

upload_id
string
required

Private visual-upload id.

Pattern: ^vup_[a-f0-9]{24}$
method
any
required
upload_url
string<uri>
required
required_headers
object
required
expires_at
string<date-time>
required