Account actions
The account plane is one person's own account: their profile, sessions, the apps they have allowed to act for them, their personal API keys and trusted devices. Only that person reaches it — in the console, or through a token they delegated. No management key acts as a person, and there is no account id in any path.
Every row below is one action, reached through four doors that run the same code, with the same authorization, validation, approvals and Audit log entry: the console, the REST API, the MCP server and the cbox CLI. See Actions for how that works and Planes and hosts for where each plane is served.
|
|
| REST |
https://<host>/api/v1/me/… with a token you delegated — on your environment's host, or on the platform root for a workspace team member or operator |
| MCP |
/mcp on the same host, signed in as yourself |
| CLI |
cbox login, then the command below |
| OpenAPI |
/api/v1/me/openapi.yaml on the host above — public, no key needed (source); every operation carries x-action, x-scope and x-danger |
Danger is how much harm the action can do in the wrong hands: read only reads; write changes something another write can undo; destructive removes or revokes; critical mints credentials, takes over access or changes how people sign in. MCP clients are told a destructive or critical tool is destructive, the CLI asks before running one, and an approval policy keys on it.
Contents
| Area |
Actions |
| API keys |
account.api_keys.create, account.api_keys.revoke |
| App catalog |
account.apps.list |
| Applications |
account.applications.revoke |
| Connected services |
account.pipes.disconnect |
| Devices |
account.devices.remove |
| Organizations |
account.organizations.leave |
| Profile |
account.email.confirmation.send, account.profile.update |
| Service waitlists |
account.waitlists.join, account.waitlists.leave |
| Sessions |
account.sessions.revoke, account.sessions.revoke_others |
| Sign-in methods |
account.mfa.sms.remove, account.passkeys.remove, account.passkeys.rename, account.sign_in_methods.disconnect, account.social.unlink, account.totp.remove, account.totp.rename |
API keys
account.api_keys.create
Create an API key of your own for one of this environment's apps, in an organization you belong to. The value is returned once, as token.
|
|
| REST |
POST /api/v1/me/organizations/{organization_id}/api-keys → 201 |
| Scope |
account:api_keys:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
critical |
| MCP tool |
account_api_keys_create |
| CLI |
cbox id account api_keys create <organization_id> |
| Secret |
data.token — shown once, never kept for an idempotent replay |
| Input |
Type |
Required |
Description |
organization_id |
string (path) |
yes |
|
client_id |
string |
yes |
The app this key is for. At most 255 characters. |
name |
string |
yes |
At most 120 characters. |
permissions |
list of string |
no |
What the key may do in the app — each one a permission you hold there. Empty: it only identifies you. At most 200 items. |
expires_at |
string (date-time), nullable |
no |
When it stops working. Left out, it does not expire. |
account.api_keys.revoke
Revoke one of your own API keys.
|
|
| REST |
DELETE /api/v1/me/organizations/{organization_id}/api-keys/{key_id} → 204 |
| Scope |
account:api_keys:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
destructive |
| MCP tool |
account_api_keys_revoke |
| CLI |
cbox id account api_keys revoke <organization_id> <key_id> |
| Input |
Type |
Required |
Description |
organization_id |
string (path) |
yes |
|
key_id |
string (path) |
yes |
|
App catalog
account.apps.list
List the published apps visible to you in this environment. Optional organization context must be one you actively belong to.
|
|
| REST |
GET /api/v1/me/apps → 200 |
| Scope |
account:apps:read — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
read |
| MCP tool |
account_apps_list |
| CLI |
cbox id account apps list |
| Input |
Type |
Required |
Description |
organization_id |
string, nullable |
no |
At most 64 characters. |
Applications
account.applications.revoke
Withdraw an application's access to your account; it must ask you again to act as you.
|
|
| REST |
DELETE /api/v1/me/applications/{client_id} → 204 |
| Scope |
account:applications:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
destructive |
| MCP tool |
account_applications_revoke |
| CLI |
cbox id account applications revoke <client_id> |
| Input |
Type |
Required |
Description |
client_id |
string (path) |
yes |
|
Connected services
account.pipes.disconnect
Disconnect one of your connected services, revoking the access you gave it.
|
|
| REST |
DELETE /api/v1/me/pipes/{provider} → 204 |
| Scope |
account:pipes:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
destructive |
| MCP tool |
account_pipes_disconnect |
| CLI |
cbox id account pipes disconnect <provider> |
| Input |
Type |
Required |
Description |
provider |
string (path) |
yes |
The provider's key, for example github. At most 64 characters. |
Devices
account.devices.remove
Remove one of your trusted devices; it is no longer asked to approve anything.
|
|
| REST |
DELETE /api/v1/me/devices/{device_id} → 204 |
| Scope |
account:devices:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
destructive |
| MCP tool |
account_devices_remove |
| CLI |
cbox id account devices remove <device_id> |
| Input |
Type |
Required |
Description |
device_id |
string (path) |
yes |
|
Organizations
account.organizations.leave
Leave one of your own organizations. The last owner cannot leave — transfer ownership first.
|
|
| REST |
POST /api/v1/me/organizations/{organization_id}/leave → 204 |
| Scope |
account:organizations:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
destructive |
| MCP tool |
account_organizations_leave |
| CLI |
cbox id account organizations leave <organization_id> |
| Input |
Type |
Required |
Description |
organization_id |
string (path) |
yes |
The organization you are leaving — one you are a member of. At most 64 characters. |
Profile
account.email.confirmation.send
Mail yourself a link that confirms your email address.
|
|
| REST |
POST /api/v1/me/email/confirmation → 200 |
| Scope |
account:profile:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
write |
| MCP tool |
account_email_confirmation_send |
| CLI |
cbox id account email confirmation send |
Takes no input.
account.profile.update
Change the display name on your own account.
|
|
| REST |
PATCH /api/v1/me/profile → 200 |
| Scope |
account:profile:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
write |
| MCP tool |
account_profile_update |
| CLI |
cbox id account profile update |
| Input |
Type |
Required |
Description |
name |
string |
yes |
Your display name. At least 1 characters. At most 120 characters. |
Service waitlists
account.waitlists.join
Join a published service waitlist with your verified email. Does not buy a plan or grant access.
|
|
| REST |
POST /api/v1/me/services/{program}/waitlist → 200 |
| Scope |
account:waitlists:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
write |
| MCP tool |
account_waitlists_join |
| CLI |
cbox id account waitlists join <program> |
| Input |
Type |
Required |
Description |
program |
integer (path) |
yes |
At least 1. |
organization |
string, nullable |
no |
An active team you belong to; required for feature waitlists. At most 64 characters. |
interest |
string, nullable |
no |
Feature updates or participation in a test group. One of notify, test. |
country |
string, nullable |
no |
Optional two-letter country code. At most 2 characters. |
answers |
object |
no |
Answers by the programme’s question keys, at most 2000 characters each. At most 20. |
reference |
string (uuid) |
yes |
A stable UUID for this signup attempt, also used for Billing idempotency. At most 36 characters. |
account.waitlists.leave
Withdraw your own feature interest or beta application for a team. Active grants are managed by the service.
|
|
| REST |
POST /api/v1/me/services/{program}/waitlist/leave → 200 |
| Scope |
account:waitlists:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
write |
| MCP tool |
account_waitlists_leave |
| CLI |
cbox id account waitlists leave <program> |
| Input |
Type |
Required |
Description |
program |
integer (path) |
yes |
At least 1. |
organization |
string |
yes |
At most 64 characters. |
reference |
string (uuid) |
yes |
At most 36 characters. |
Sessions
account.sessions.revoke
Sign out one of your own sessions.
|
|
| REST |
DELETE /api/v1/me/sessions/{session_id} → 204 |
| Scope |
account:sessions:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
destructive |
| MCP tool |
account_sessions_revoke |
| CLI |
cbox id account sessions revoke <session_id> |
| Input |
Type |
Required |
Description |
session_id |
string (path) |
yes |
|
account.sessions.revoke_others
Sign out every one of your sessions except the one you are using.
|
|
| REST |
POST /api/v1/me/sessions/revoke-others → 200 |
| Scope |
account:sessions:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
critical |
| MCP tool |
account_sessions_revoke_others |
| CLI |
cbox id account sessions revoke_others |
Takes no input.
Sign-in methods
account.mfa.sms.remove
Remove your phone number for text-message sign-in codes.
|
|
| REST |
DELETE /api/v1/me/mfa/sms → 204 |
| Scope |
account:sign_in:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
critical |
| MCP tool |
account_mfa_sms_remove |
| CLI |
cbox id account mfa sms remove |
Takes no input.
account.passkeys.remove
Remove one of your passkeys.
|
|
| REST |
DELETE /api/v1/me/passkeys/{passkey_id} → 204 |
| Scope |
account:sign_in:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
critical |
| MCP tool |
account_passkeys_remove |
| CLI |
cbox id account passkeys remove <passkey_id> |
| Input |
Type |
Required |
Description |
passkey_id |
string (path) |
yes |
|
account.passkeys.rename
Rename one of your passkeys.
|
|
| REST |
PATCH /api/v1/me/passkeys/{passkey_id} → 200 |
| Scope |
account:sign_in:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
write |
| MCP tool |
account_passkeys_rename |
| CLI |
cbox id account passkeys rename <passkey_id> |
| Input |
Type |
Required |
Description |
passkey_id |
string (path) |
yes |
|
name |
string |
yes |
What to call the passkey: one to 64 characters, no line breaks. At least 1 characters. At most 64 characters. |
account.sign_in_methods.disconnect
Disconnect one linked sign-in identity (Google, GitHub, …) from your account — never the last way you can sign in.
|
|
| REST |
DELETE /api/v1/me/sign-in-methods/{identity_id} → 204 |
| Scope |
account:sign_in:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
critical |
| MCP tool |
account_sign_in_methods_disconnect |
| CLI |
cbox id account sign_in_methods disconnect <identity_id> |
| Input |
Type |
Required |
Description |
identity_id |
string (path) |
yes |
The linked identity's id, as My account lists it. |
account.social.unlink
Disconnect a social account from yours — never the last way you can sign in.
|
|
| REST |
DELETE /api/v1/me/social/{provider} → 204 |
| Scope |
account:sign_in:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
critical |
| MCP tool |
account_social_unlink |
| CLI |
cbox id account social unlink <provider> |
| Input |
Type |
Required |
Description |
provider |
string (path) |
yes |
The provider's key, for example google. |
account.totp.remove
Remove one of your authenticator apps.
|
|
| REST |
DELETE /api/v1/me/two-factor/apps/{factor_id} → 204 |
| Scope |
account:sign_in:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
critical |
| MCP tool |
account_totp_remove |
| CLI |
cbox id account totp remove <factor_id> |
| Input |
Type |
Required |
Description |
factor_id |
string (path) |
yes |
|
account.totp.rename
Rename one of your authenticator apps.
|
|
| REST |
PATCH /api/v1/me/two-factor/apps/{factor_id} → 204 |
| Scope |
account:sign_in:write — on an access token you delegated; it acts on your own account only. No management key is accepted. |
| Danger |
write |
| MCP tool |
account_totp_rename |
| CLI |
cbox id account totp rename <factor_id> |
| Input |
Type |
Required |
Description |
factor_id |
string (path) |
yes |
|
name |
string |
yes |
At least 1 characters. At most 120 characters. |