Personal API tokens

Personal tokens are the simplest way to access the API. They are long-lived, tied to your Visuary account, and can be revoked at any time from your account settings.

Use personal tokens for scripts, automation pipelines, and direct server-to-server integrations where there is no end-user involved.

---

Creating a token

1. In your Visuary account, open Settings → API Access
2. Under Personal tokens, click + Create token
3. Give the token a descriptive name — this is for your reference only (e.g. export-script, ci-pipeline)
4. Copy the token value — it is shown only once and cannot be retrieved again

---

Using a token

Include the token as a Bearer header on every API request:

curl https://api.visuary.com/public/v1/workspaces \
  -H "Authorization: Bearer YOUR_TOKEN"

---

Testing your token

A quick smoke-test: call the workspaces endpoint and expect a JSON array back.

curl -s https://api.visuary.com/public/v1/workspaces \
  -H "Authorization: Bearer YOUR_TOKEN" | jq .

A 401 response means the token is invalid or missing. A 200 with an empty array [] means the token works but your account has no accessible workspaces.

---

Revoking a token

Go to Settings → API Access → Personal tokens, find the token by name, and click Revoke. Revocation is immediate — any in-flight requests using that token will fail.

OAuth-issued tokens (granted to your account by a third-party app) also appear in the same list and can be revoked there.

---

Error responses

Status	Meaning
401	Missing or invalid token
403	Token valid but no access (plan permissions or subscription level)
400	Bad request — check query parameters or path
500	Server error