Skip to main content
Use an upload when you do not want a large file inside the JSON body. Get an address, PUT the raw bytes to it (no base64), then pass the uploadId to Parse as uploadRef. Needs an API key. Get one in the Quickstart.
cURL
The first call returns uploadUrl, uploadId, expiresAt and maxBytes. Keep the URL private. The PUT answers an empty 200. The parse answer is the one in Parse, here with data.pages. POST /v1/parse takes uploadRef in place of file, and every other field works the same.

Limits

  • PUT within 15 minutes of getting the address, and parse within 1 hour.
  • Each uploadId parses once. The file is deleted when the parse ends, and a repeat or late parse returns 404 notFound.
  • Parsing before the PUT returns 400 invalidRequest. A file over 36 MB returns 400 and the upload is deleted.
  • uploadRef without a key returns 400 invalidRequest.
Getting the address is free. See Pricing for the parse.