Use Portal Actions

Use the CLI whenever the action ID is known directly or can be found through one action listing.

Discover and inspect

npx @spotify/portal-cli actions list --json
npx @spotify/portal-cli actions <action-id> --help

Prefer a dedicated CLI workflow such as search, owner, or service when it already matches the user's goal.

Invoke safely

For read-only actions, use JSON output and pass only documented flags.

For mutations: