API referencePins
Mark a queued source read
It leaves the queue; the pin is kept (unlike DELETE). 404 when the source is not in the caller's queue.
POST
Sends a real request with your token. Prefer a read-only token; it is kept in this browser's storage.
It leaves the queue; the pin is kept (unlike DELETE). 404 when the source is not in the caller's queue.
header
AuthorizationBearer <token>A personal access token (rsk_…) or a Supabase access token.
sourceId*stringLength
1 <= length <= 64The pin
application/json- response
bookmark_id*stringMatch
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidpinned_at*stringread_at*string|nullcurl -X POST 'https://www.ressource.social/api/v1/pins/string/read'{ "bookmark_id": "49a78d35-bc45-4a39-a336-d00349864577", "pinned_at": "string", "read_at": "string"}The caller's read-later queue GET
Unread pins, most recently pinned first, each with the source's title, URL and owner. A source the caller can no longer open drops out.
Put a source in the read-later queue PUT
Idempotent. Already queued is a no-op; already read puts it back in the queue. A source the caller cannot open is 404.