Skip to content

Preferences actions

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

Get the mode order.

Route GET /api/v1/preferences/mode-order
Tool name calternal_api_preferences_mode_order_get
Surfaces cli, mcp, webmcp
Scopes account
Effect read only
Encoding request none, response json
Terminal window
calternal action run preferences_mode_order_get --input '{}' --json

Update the mode order. Body fields: mode_order..

Route PUT /api/v1/preferences/mode-order
Tool name calternal_api_preferences_mode_order_put
Surfaces cli, mcp, webmcp
Scopes account
Effect destructive, needs --confirm
Encoding request json, response json

body

Field Type Required Description
mode_order array of string yes Stable Plugin IDs in the User’s chosen order.
Terminal window
calternal action run preferences_mode_order_put --input '{}' --confirm --json