ressource.socialbetadocumentation
API referenceAi

Suggest tags for a page with Claude

3–6 tags, reusing the caller's own tags (and their casing) where they fit. Page text, in order: the caller's own extract of that URL, `page_text`, a server fetch; without any, title and URL are used. Refusals carry `details.assist`: `disabled` / `forbidden` (403 — the assists are off, or the user holds no grant), `quota_exceeded` (429), `no_page_text` (404 — nothing readable to rewrite from), `upstream` / `invalid_output` (500). Session callers only: a personal access token or an OAuth client gets 403.

POST
/api/v1/ai/suggest-tags

Sends a real request with your token. Prefer a read-only token; it is kept in this browser's storage.

3–6 tags, reusing the caller's own tags (and their casing) where they fit. Page text, in order: the caller's own extract of that URL, page_text, a server fetch; without any, title and URL are used. Refusals carry details.assist: disabled / forbidden (403 — the assists are off, or the user holds no grant), quota_exceeded (429), no_page_text (404 — nothing readable to rewrite from), upstream / invalid_output (500). Session callers only: a personal access token or an OAuth client gets 403.

Authorization

headerAuthorizationBearer <token>

A personal access token (rsk_…) or a Supabase access token.

Request Body

application/json
  1. body
url*string
Formaturi
Lengthlength <= 2048
title?|null
description?|null
page_text?string|null
locale?string
Value in"en""fr"

Response Body

Suggested tags

application/json
  1. response
tags*array<string>
had_page_text*boolean
curl -X POST 'https://www.ressource.social/api/v1/ai/suggest-tags' \  -H 'Content-Type: application/json' \  -d '{  "url": "http://example.com"}'
{  "tags": [    "string"  ],  "had_page_text": true}