Skip to main content
GET
/
api
/
admin
/
notion
/
status
Current org's Notion connection status
curl --request GET \
  --url https://archyon.app/api/admin/notion/status \
  --header 'Authorization: Bearer <token>'
{
  "configured": true,
  "oauthReady": true,
  "redirectUri": "<string>",
  "workspaceId": "<string>",
  "workspaceName": "<string>",
  "workspaceIcon": "<string>",
  "botId": "<string>",
  "ownerName": "<string>"
}

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.

Response

OK.

​
configured
boolean
required

True if this org has a stored Notion access token.

​
oauthReady
boolean
required

True if the deployment has both NOTION_OAUTH_CLIENT_ID and NOTION_OAUTH_CLIENT_SECRET set.

​
redirectUri
string | null

The exact URL the server will send Notion as redirect_uri. Must be registered in Notion char-for-char.

​
workspaceId
string | null
​
workspaceName
string | null
​
workspaceIcon
string | null
​
botId
string | null
​
ownerName
string | null