URL Scheme API
Settings Action
Deep-link into Statuz settings or toggle entire platforms programmatically
Settings Action
Open Statuz settings to a specific section or toggle platform-level posting switches directly from scripts and launchers.
Syntax
statuz://settings[?parameters]
Parameters
| Parameter | Type | Description | Required | Example |
|---|---|---|---|---|
section | string | Settings pane to open: general, composer, social/accounts, bluesky, mastodon, x, shortcuts/keyboard, data, ai/mcp | No | social |
platform | string | Platform identifier when toggling (x, bluesky, mastodon) | With set-enabled | x |
set-enabled | boolean | Globally enable/disable posting for the specified platform | With platform | false |
You can combine platform and set-enabled with section when you want to open the pane and flip the toggle simultaneously.
Examples
Open Account Settings
open "statuz://settings?section=social"
Jump Straight to MCP Server Preferences
open "statuz://settings?section=ai"
Disable a Platform
open "statuz://settings?platform=mastodon&set-enabled=false"
Re-enable Posting Everywhere
open "statuz://settings?platform=x&set-enabled=true"
open "statuz://settings?platform=bluesky&set-enabled=true"
open "statuz://settings?platform=mastodon&set-enabled=true"