sazabi components

sazabi components — Manage status page components. Subcommands: list, get, scan, register, deregister, rename, reactivate, merge, relationships.

`sazabi components`

Manage status page components

sazabi components <subcommand>

sazabi components list  # List all components
sazabi components get <component-id>  # Get one component
sazabi components register --name "API Gateway"  # Register a component
sazabi components deregister <component-id>  # Deregister a component

`sazabi components list`

List components in the active project

sazabi components list [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--limit`	string	No	Maximum number of components to return (default: 50, max: 100)
`--cursor`	string	No	Pagination cursor from previous response
`--include-deleted`	boolean	No	Include deregistered components

sazabi components list  # List all components
sazabi components list --include-deleted  # Include deregistered components

`sazabi components get`

Get one component by ID

sazabi components get <component-id> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON

sazabi components get <component-id>  # Get one component

`sazabi components scan`

Detect component candidates in the working tree (propose-only)

sazabi components scan [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--dir`	string	No	Directory to scan (default: current directory)

sazabi components scan  # Detect candidates and confirm which to register
sazabi components scan --json  # Print candidates only, register nothing

`sazabi components register`

sazabi components register [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--name`	string	No	Component name to register
`--description`	string	No	Optional component description
`--origin`	string	No	Machine provenance: 'code_detected' (inferred from code) or 'log_observed' (inferred from telemetry, the default)

sazabi components register --name "API Gateway"  # Register a component
sazabi components register --name "Checkout" --description "Checkout API and workflow"  # Register with description
sazabi components register --name "intake-consumer" --origin code_detected  # Register a component inferred from repository analysis

`sazabi components deregister`

Withdraw an observation, or preview and confirm a deregistration

sazabi components deregister <component-id> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--confirm-preview-revision`	string	No	Exact componentRevisions JSON from the preview; omit to preview only
`--request-id`	string	No	Project-scoped UUID idempotency key required for commit
`--reason`	string	No	Deregistration reason; optional for withdrawal and preview, required for commit
`--confirm-canonical-group`	boolean	No	Confirm the complete canonical group

sazabi components deregister <component-id>  # Withdraw an observation or preview the impact
sazabi components deregister <component-id> --confirm-preview-revision '{"<component-id>":7}' --request-id <uuid> --reason "replaced by the worker service"  # Commit the deregistration

`sazabi components rename`

Rename an active component

sazabi components rename <component-id> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--name`	string	No	New component name
`--request-id`	string	No	Project-scoped UUID idempotency key
`--reason`	string	No	Audit reason for the rename

`sazabi components reactivate`

Preview or confirm component reactivation

sazabi components reactivate <component-id> [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--confirm-preview-revision`	string	No	Exact componentRevisions JSON from the preview; omit to preview only
`--request-id`	string	No	Project-scoped UUID idempotency key required for commit
`--reason`	string	No	Audit reason required for commit
`--deregistration-operation-id`	string	No	Deregistration operation ID returned by the preview
`--notification-rule-ids`	string	No	Comma-separated eligible notification rule IDs
`--automation-binding-ids`	string	No	Comma-separated eligible automation binding IDs
`--relationship-ids`	string	No	Comma-separated eligible relationship IDs

`sazabi components merge`

Preview or confirm present-day component consolidation

sazabi components merge [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--confirm-preview-revision`	string	No	Exact componentRevisions JSON from the preview; omit to preview only
`--request-id`	string	No	Project-scoped UUID idempotency key required for commit
`--reason`	string	No	Audit reason required for commit
`--source`	string	No	Source component ID
`--target`	string	No	Target component ID
`--policy-dispositions`	string	No	Exact non-equivalent policy disposition JSON
`--confirm-policy-impact`	boolean	No	Confirm every previewed policy-scope change

sazabi components merge --source <component-id> --target <component-id>  # Preview only

`sazabi components relationships`

Inspect and edit component topology

sazabi components relationships <subcommand>

`sazabi components relationships list`

List component relationships

sazabi components relationships list [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--include-historical`	boolean	No	Include historically ended relationships

`sazabi components relationships add`

Add a component relationship

sazabi components relationships add [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--confirm-preview-revision`	string	No	Exact componentRevisions JSON from the preview; omit to preview only
`--request-id`	string	No	Project-scoped UUID idempotency key required for commit
`--reason`	string	No	Audit reason required for commit
`--source`	string	No	Source component ID
`--target`	string	No	Target component ID
`--type`	string	No	Relationship type: part_of or depends_on
`--confirm-policy-impact`	boolean	No	Confirm the policy-scope delta shown by the preview

sazabi components relationships add --source <component-id> --target <component-id> --type part_of  # Preview a parent-child topology change

`sazabi components relationships remove`

End a component relationship

sazabi components relationships remove [options]

Flag	Type	Required	Description
`--token`	string	No	Override token
`--api-base-url`	string	No	Override API base URL
`--json`	boolean	No	Output as JSON
`--confirm-preview-revision`	string	No	Exact componentRevisions JSON from the preview; omit to preview only
`--request-id`	string	No	Project-scoped UUID idempotency key required for commit
`--reason`	string	No	Audit reason required for commit
`--source`	string	No	Source component ID
`--target`	string	No	Target component ID
`--type`	string	No	Relationship type: part_of or depends_on
`--confirm-policy-impact`	boolean	No	Confirm the policy-scope delta shown by the preview

sazabi components relationships remove --source <component-id> --target <component-id> --type part_of  # Preview a parent-child topology change

On this page