Skip to main content
These routes save, list, change and remove the website logins a person’s agents can sign in with, and connect that person’s 1Password. Every route is a person’s: it passes the person check or answers 403 { "ok": false, "error": "person_only" }, and it acts for that person. A person a sign-in proxy vouched for sees and changes only their own logins; the dashboard on an install with one person acts as its one person. Examples use the default port 18790. Add the access cookie to each curl, as shown under Authentication. Writes count against the stricter sensitive limit (see the REST API overview). No answer carries a value. A username, password, one-time code key or 1Password token goes in once and is never read back. An error is a code from the lists below, never the request’s own text.

Routes

GET /api/website-logins

fillAvailable is whether a browser connector (Playwright or Chrome DevTools) is connected. When it is false, fill_login is not offered to any agent.

POST /api/website-logins

Body: site (required), password (required), and optional username, oneTimeCodeSecret and label.
  • site is a host or an address. Clawboo keeps its origin; a bare host is read as https. Plain http is refused except on localhost, 127.0.0.1 and [::1].
  • oneTimeCodeSecret is the base32 setup key a site shows for an authenticator app (spaces and dashes are ignored).
  • Limits: username 512 characters, password 1,024, key 256, label 120.
Answers 201 { "ok": true, "login": { … } } with the same fields as a list entry.

PATCH /api/website-logins/:id

Every field is optional; a field you leave out keeps its value.
  • password: a new password. An empty string keeps the old one.
  • username: a new username. An empty string clears it.
  • oneTimeCodeSecret: a new key, or null (or an empty string) to remove it.
  • site, label: as for POST. An empty label clears it.
Answers { "ok": true, "login": { … } }, or 404 not_found for a login that is not yours, plus the POST errors.

DELETE /api/website-logins/:id

Answers { "ok": true }, or 404 not_found for a login that is not yours.

PUT /api/website-logins/sources/1password

Body: { "token": "ops_…" }, a 1Password service account token. Clawboo checks the token by listing the vaults it can read, and saves it in the vault only when it can read at least one. It replaces your earlier token. Answers { "ok": true, "vaults": 2 }: how many vaults it can read, never their names.

POST /api/website-logins/sources/1password/install

Downloads 1Password’s SDK, version 0.5.0 (about 14 MB), into the runtimes folder, once. It is not part of Clawboo’s own install. The first call takes as long as the download; a second call while one runs waits for the same one, and a call after it is installed answers at once. GET /api/website-logins reports onePassword.sdkInstalled and onePassword.sdkInstalling. Answers { "ok": true }, or 502 with:

DELETE /api/website-logins/sources/1password

Forgets your token. Answers { "ok": true }.
Last modified on November 14, 2026