List saved links

GET

/api/v1/saved_links

const url = 'https://api.inside.chat/api/v1/saved_links?website_id=example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.inside.chat/api/v1/saved_links?website_id=example' \
  --header 'Authorization: Bearer <token>'

Required scopes: conversation_read
Data access: –
MCP tool: saved_links

Read a bounded descending catalogue of static website-global saved links with safe HTTP(S) URLs. Unrestricted installation policy required. Private operator, subsite, dynamic and scripted links are excluded before pagination. No visitor context, custom scripts or remote requests are invoked.

Authorizations

installation_token
oauth_client_credentials
conversation_read

Parameters

Query Parameters

website_id

required

string

/^web_[0-9]{1,20}_[1-9][0-9]{0,18}$/

An explicitly granted website.

limit

integer

>= 1 <= 100

cursor

Continue before the last delivered positive native saved-link ID (maximum 9223372036854775807). The selected website remains authoritative.

string

<= 19 characters /^[1-9][0-9]{0,18}$/

Responses

200

Authorized result. Projection depends on current scopes and data policy.

application/json

object

data

required

object

scope

required

Allowed value: website_global

saved_links

required

Array<object>

<= 100 items

object

required

string

<= 19 characters /^[1-9][0-9]{0,18}$/

label

required

string

<= 240 characters

url

required

string format: uri

<= 2048 characters /^[Hh][Tt][Tt][Pp][Ss]?:///

next_cursor

required

Any of:

string
null

string

<= 19 characters /^[1-9][0-9]{0,18}$/

coverage

required

Allowed value: website_global_static_saved_links

Example

{
  "data": {
    "scope": "website_global",
    "coverage": "website_global_static_saved_links"
  }
}

400

Invalid, duplicate or unsupported request parameters.

401

Missing, expired or revoked installation credential.

404

Resource not found or not permitted by current authority.

422

The requested capability is not available for application installations.

429

Per-app quota exceeded.

Headers

Retry-After

integer

>= 1

503

Enrollment, native service or required authority is unavailable.