CLI

Command Reference

Complete reference for all Status200 CLI commands.

Authentication Commands

status200 login

Authenticate with a Status200 instance.

status200 login <api-key> <instance-url> [--context-name <name>]
ParameterTypeRequiredDescription
<api-key>argumentYesAPI key for authentication
<instance-url>argumentYesStatus200 instance URL
--context-nameoptionNoContext name (default: "default")

status200 context list

List all saved contexts.

status200 context list

status200 context use

Switch to a named context.

status200 context use <name>
ParameterTypeRequiredDescription
<name>argumentYesContext name to activate

status200 context current

Display the active context with masked API key.

status200 context current

status200 context delete

Remove a saved context.

status200 context delete <name>
ParameterTypeRequiredDescription
<name>argumentYesContext name to delete

Resource Commands

All resource commands follow the same pattern. Replace <resource> with any supported resource name (e.g., incident, monitor, alert, status-page).

status200 <resource> list

List resources with filtering and pagination.

status200 <resource> list [options]
OptionTypeDefaultDescription
--query <json>stringNoneFilter criteria as JSON
--limit <n>number10Maximum results
--skip <n>number0Results to skip
--sort <json>stringNoneSort order as JSON
-o, --outputstringtableOutput format

status200 <resource> get

Get a single resource by ID.

status200 <resource> get <id> [-o <format>]
ParameterTypeRequiredDescription
<id>argumentYesResource ID (UUID)
-o, --outputoptionNoOutput format

status200 <resource> create

Create a new resource.

status200 <resource> create [--data <json> | --file <path>] [-o <format>]
OptionTypeRequiredDescription
--data <json>stringOne of --data or --fileResource data as JSON
--file <path>stringOne of --data or --filePath to JSON file
-o, --outputstringNoOutput format

status200 <resource> update

Update an existing resource.

status200 <resource> update <id> --data <json> [-o <format>]
ParameterTypeRequiredDescription
<id>argumentYesResource ID
--data <json>optionYesFields to update as JSON
-o, --outputoptionNoOutput format

status200 <resource> delete

Delete a resource.

status200 <resource> delete <id> [--force]
ParameterTypeRequiredDescription
<id>argumentYesResource ID
--forceoptionNoSkip confirmation prompt

status200 <resource> count

Count resources matching a filter.

status200 <resource> count [--query <json>]
OptionTypeDefaultDescription
--query <json>stringNoneFilter criteria as JSON

Utility Commands

status200 version

Display the CLI version.

status200 version

status200 whoami

Show current authentication details.

status200 whoami

Displays the instance URL and masked API key. If a saved context is active, the context name is also shown.


status200 resources

List all available resource types.

status200 resources [--type <type>]
OptionTypeDefaultDescription
--type <type>stringNoneFilter by database or analytics

Global Options

These flags are available on all commands:

OptionDescription
--api-key <key>Override API key
--url <url>Override instance URL
--context <name>Use a specific context
-o, --output <format>Output format: json, table, wide
--no-colorDisable colored output
--helpShow help
--versionShow version

API Routes

For reference, the CLI maps commands to these API endpoints:

CommandMethodEndpoint
listPOST/api/<resource>/get-list
getPOST/api/<resource>/<id>/get-item
createPOST/api/<resource>
updatePUT/api/<resource>/<id>/
deleteDELETE/api/<resource>/<id>/
countPOST/api/<resource>/count

All requests include the APIKey header for authentication.