Skip to content

Changelog

The first public release of the PhotoPick API.

  • GET /api/v1/me — inspect the current API key (scopes, rate limit, customer).
  • GET /api/v1/customer — read the customer account.
  • GET /api/v1/photos, GET /api/v1/photos/{id} — list and read photos.
  • GET /api/v1/photos/{id}/download — fetch the photo file, optionally resized (size=original|a4|fhd|web) and re-encoded (format=original|jpeg|webp).
  • GET /api/v1/photos/{id}/tags, PUT /api/v1/photos/{id}/tags — read and replace tags on a photo.
  • PATCH /api/v1/photos/{id}, DELETE /api/v1/photos/{id} — edit and delete photos.
  • GET /api/v1/tags, GET /api/v1/tags/{id} — list and read tags.
  • POST /api/v1/tags, PATCH /api/v1/tags/{id}, DELETE /api/v1/tags/{id} — create, rename, delete tags.
  • Bearer authentication with six scopes (customer:read, photos:read, photos:write, photos:delete, tags:read, tags:write).
  • Optional per-key IP whitelist.
  • Cursor pagination on list endpoints.
  • Standard error envelope with machine-readable code field, including tariff_not_supported (403) for features blocked by the customer’s subscription tier.
  • Rate limit headers (X-RateLimit-*) on every response.