Apps actions

4 actions. Each action calls the same API route with the same scopes on every surface.

app_surfaces_get

Get app surface settings.

Route	GET /api/v1/apps/surfaces
Tool name	calternal_api_app_surfaces_get
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	read only
Encoding	request none, response json

calternal action run app_surfaces_get --input '{}' --json

app_surfaces_put

Update app surface settings. Body fields: enabled, surface..

Route	PUT /api/v1/apps/surfaces
Tool name	calternal_api_app_surfaces_put
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	destructive, needs --confirm
Encoding	request json, response json

body

Field	Type	Required	Description
enabled	boolean	yes
surface	"notes" | "api" | "cli" | "mcp" | "mcp_events" | "webmcp"	yes	These gates protect external automation credentials. Browser sessions remain usable so a User can always restore their own access in Settings.

calternal action run app_surfaces_put --input '{}' --confirm --json

mcp_event_revoke

Revoke an App event subscription.

Route	DELETE /api/v1/apps/events/subscriptions/{id}
Tool name	calternal_api_mcp_event_revoke
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

calternal action run mcp_event_revoke --input '{"path":{"id":"<id>"}}' --confirm --json

mcp_event_subscriptions

List App event subscriptions.

Route	GET /api/v1/apps/events/subscriptions
Tool name	calternal_api_mcp_event_subscriptions
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	read only
Encoding	request none, response json

calternal action run mcp_event_subscriptions --input '{}' --json