Changelog
v1.0.0 — Initial release
Section titled “v1.0.0 — Initial release”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
codefield, includingtariff_not_supported(403) for features blocked by the customer’s subscription tier. - Rate limit headers (
X-RateLimit-*) on every response.