Skip to content

Account actions

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.

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.