connected-apps · MachineMail Docs

Apps and MCP clients connected with OAuth.

Command	Summary
`connected-apps delete`	Disconnect app
`connected-apps list`	List connected apps

Every command also takes the global flags.

connected-apps delete

Disconnect app.

Also: machinemail connected-apps rm.

Revokes the grant: its refresh token and every access token issued from it stop working immediately (401 on /mcp and /v0). Returns the grant as it was. Requires an organization-scoped credential with api_key_delete.

shell

machinemail connected-apps delete <grant-id> [flags]

Arguments

<grant-id>stringRequired

ID of the grant (oag_...).

Examples

shell

machinemail connected-apps delete <grant-id>

API

DELETE /v0/oauth-grants/{grant_id}

connected-apps list

List connected apps.

Also: machinemail connected-apps ls.

Apps and MCP clients people in the organization connected with OAuth. Requires an organization-scoped credential with api_key_read; pod, inbox and sandbox credentials get 403.

shell

machinemail connected-apps list [flags]

Flags

--limit <n>integer

Maximum number of items to return. Default 50, maximum 500; larger values are capped.

Default50

--page-token <value>string

next_page_token from the previous page.

--ascendingboolean

Sort oldest first.

--allboolean

Follow next_page_token and return every page.

Examples

shell

machinemail connected-apps list
machinemail connected-apps list --all --json | jq '.oauth_grants | length'

API

GET /v0/oauth-grants