ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiUploads

Mint client-upload token (used by @vercel/blob/client)

POST
/api/v1/uploads/handle

Internal endpoint invoked by the @vercel/blob/client upload() function. Validates the requested pathname, then returns a constrained client token (image types only, 5 MB max, random suffix). Auth: zap_* API key with uploads:write scope, or dashboard JWT.

Authorization

bearer

Header Parameters

X-API-Version?string

API version for header-based versioning

Default"1"
Value in"1""2"

Response Body

Client token generated (or upload-completed acknowledged).

Example Request
curl -X POST 'http://localhost:3001/api/v1/uploads/handle'
Example Response200
Empty