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.
siteis a host or an address. Clawboo keeps its origin; a bare host is read ashttps. Plainhttpis refused except onlocalhost,127.0.0.1and[::1].oneTimeCodeSecretis 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.
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, ornull(or an empty string) to remove it.site,label: as for POST. An emptylabelclears it.
{ "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 }.