Skip to main content
POST
/
api
/
workspaces
/
{id}
/
components
/
{cid}
/
links
/
{linkId}
/
refresh
Re-fetch a Notion-backed link's metadata
curl --request POST \
  --url https://archyon.app/api/workspaces/{id}/components/{cid}/links/{linkId}/refresh \
  --header 'Authorization: Bearer <token>'
{
  "link": {
    "id": 123,
    "workspaceId": "<string>",
    "componentId": "<string>",
    "kind": "<string>",
    "url": "<string>",
    "createdAt": 123,
    "createdBy": 123,
    "properties": {},
    "targetId": "<string>",
    "title": "<string>",
    "icon": "<string>",
    "fetchedAt": 123
  },
  "unchanged": "<unknown>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.archyon.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Both Clerk session JWTs (browser) and Archyon Personal Access Tokens (an_pat_…, server / CLI / MCP) use the same Bearer header. The server distinguishes them by token shape.

  • Clerk JWTs carry org context in the token claims (org_id, org_role, org_slug) — required for org-scoped endpoints. Configure your Clerk session template to include these claims; see DEPLOYMENT.md.
  • PATs are minted at /account → Tokens. Each PAT is bound to whichever org was active at mint time. Switch orgs and re-mint to address a different org.

Path Parameters

​
id
string
required

Workspace id (slug-like; provided at create time).

​
cid
string
required
​
linkId
integer
required

Response

OK.

​
link
object
required
​
unchanged
any