PPhotoDesk Get started

API documentation

Everything you need to upload and deliver images programmatically.

Authentication

All requests are authenticated with a bearer token from your dashboard.

Authorization: Bearer YOUR_TOKEN

Upload an image

POST /v1/upload
Content-Type: multipart/form-data

file=@photo.jpg

Returns a permanent delivery URL:

{ "id": "8f2a1c",
  "url": "https://cdn.photodesk.stream/img/8f2a1c.jpg",
  "bytes": 148213 }

Fetch & resize

Append size parameters to any delivery URL — the result is generated once and cached at the edge.

GET /img/8f2a1c.jpg?w=600&h=400&fit=cover

Rate limits

Delivery is unmetered per request; uploads are limited to 100 requests/minute on Starter and 1000/minute on paid plans.

×