List a collection's photos and add or remove photos from an Unsplash collection using user authentication
domain: unsplash.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain a user (Bearer) access token via the Unsplash OAuth user authentication workflow, since collection writes require an authenticated user rather than just a Client-ID
List existing collections with GET /users/:username/collections or GET /collections, using page and per_page for pagination
Fetch a specific collection's photos with GET /collections/:id/photos
Add a photo to a collection with POST /collections/:collection_id/add, and remove one with DELETE /collections/:collection_id/remove, both requiring the write_collections scope
Read the Link response header (rel=first/prev/next/last) to page through large collections instead of guessing page counts
Known gotchas
Read/write actions on collections require a user Bearer token obtained through the OAuth workflow; a Client-ID-only request will get a 401 for private or write operations
Pagination defaults to 10 items per page with a max of 30 per page unless overridden with per_page
current_user_collections on a photo object only reflects the authenticated user's collections, not all collections a photo appears in
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?