API - Uploading images
When you upload through the API, the image itself doesn't pass through the API. We give you a short-lived, signed ticket, and you send the file straight to your account's image processor, which is built to take it.
How it works
1. Call POST /v1/uploads with the image's details: filename, title, description, keywords, creation_date, set_public_uuid and read_metadata. We check all of it here and bake it into the ticket.
POST /v1/uploads
Idempotency-Key: <uuid>
{ "filename": "IMG_1234.jpg", "title": "Sound check", "set_public_uuid": "…" }2. You get a ticket back:
{
"upload_url": "https://…imageprocessor…",
"file_field": "file",
"fields": { "…signed envelope…" },
"transaction_uuid": "…"
}3. Send the file as multipart/form-data to upload_url, including every entry from fields along with the file itself as the file part.
4. The processor creates the image and hands back its image_public_uuid, which you can then read with GET /v1/images/{that}.
Send your titles, captions and keywords to
POST /v1/uploads, not as extra parts on the upload. We check them there and put them into fields for you, so all you have to do is pass fields back exactly as they came.The ticket doesn't last long. Ask for it and upload promptly, and don't hold on to a ticket to reuse later.