Resolve a URL's title, description, preview and category
What the source form shows before saving. Counted against the caller's metadata windows (`metadata_per_hour`, `metadata_per_day`; 429 with `details` when spent). Every outbound request is SSRF-checked, including redirects and an `image` hint. Needs the `write` scope: the preview image is stored as the caller's media. With `bookmark_id` (one of the caller's imported rows, `pending`, same URL) the import window is spent instead and the row is filled in and marked `completed` — or put back to `pending` on a 429, or `failed` when the fetch fails.
Sends a real request with your token. Prefer a read-only token; it is kept in this browser's storage.
What the source form shows before saving. Counted against the caller's metadata windows (metadata_per_hour, metadata_per_day; 429 with details when spent). Every outbound request is SSRF-checked, including redirects and an image hint. Needs the write scope: the preview image is stored as the caller's media. With bookmark_id (one of the caller's imported rows, pending, same URL) the import window is spent instead and the row is filled in and marked completed — or put back to pending on a 429, or failed when the fetch fails.
AuthorizationBearer <token>A personal access token (rsk_…) or a Supabase access token.
application/json- body
url*stringurilength <= 2048hints?bookmark_id?string^([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)$uuidThe resolved metadata
response?unknownapplication/jsoncurl -X POST 'https://www.ressource.social/api/v1/metadata/url' \ -H 'Content-Type: application/json' \ -d '{ "url": "http://example.com"}'nullUpload a file POST
Multipart: `file`, `bucket` (one of avatars, bookmark-thumbnails, bookmark-attachments, bug-reports), and optional `usage_context`, `alt_text`, `description`. The file is stored under the caller and recorded as their media; the answer carries a signed URL valid for an hour. Accepted types: image/jpeg, image/jpg, image/png, image/gif, image/webp, image/svg+xml, image/avif, image/bmp, image/tiff, image/heic, image/heif, image/x-icon, image/vnd.microsoft.icon, application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, text/plain, text/markdown, application/zip, application/x-zip-compressed. At most 50 MB. Past the storage or daily upload limit, 429.
Per-community activity preferences GET
Each community the caller is a member of, with the effective switch for each activity type (the community's own, else the global one).