This reference is generated from the actual CLI command parser. Every command supports --help. Global flags can be supplied with subcommands. Examples with credentials print sensitive results only when that workflow explicitly returns them.
honeycomb#
Honeycomb is the application library for Carbons and Silicons.
Start: honeycomb search briefcase
Authenticate: honeycomb login <slt>
Publish: honeycomb validate → honeycomb pack → honeycomb apps create → honeycomb releases upload
Repository: https://github.com/teamofsilicons/silicon-honeycomb
Library: https://honeycomb.teamofsilicons.com
Rust client: https://crates.io/crates/silicon-honeycomb-client
Every command supports --help. Quote app identifiers: 'tos>briefcase'.
Usage: honeycomb [OPTIONS] <COMMAND>
Commands:
license Print Honeycomb's MIT license notice without contacting a service
iam Discover the configured IAM app identity and login URL
login Exchange an IAM short-lived token, or use `login status` to check live authentication
logout Revoke the IAM session and refresh family, then clear the local session
search Search public apps and private apps visible to your current memberships
validate Validate honeycomb.yaml and all six required targets, or a .tar.gz archive
pack Validate and build an immutable .tar.gz. Creates a template if honeycomb.yaml is absent
install Install the latest or selected app release for this platform. Collision errors suggest --alias
update Update an installed app to its latest release, preserving aliases
uninstall Uninstall only files and launchers owned by this package
installed Show packages installed in the selected home and testing environment
review Save a rating and review for an application you can access
report Report a reproducible bug; optionally link a pull request with its fix
star Star an application; repeat safely. Use --remove to remove the star
apps Create, inspect and configure organization-owned applications
releases Upload and inspect immutable CLI releases. Run pack before upload
publication Request publication and participate in application review discussions
drafts Save shared drafts with revision checks, allowing another admin to continue
operations Inspect pending operations or retry after repairing an integration
environments Create and manage isolated ecosystem testing environments
config Configure home, backend and update/telemetry preferences
daemon Run the hourly update worker, including while no interactive commands run
self-update Check for and install the latest verified Honeycomb CLI binary
service Register the per-user hourly update worker
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost
[env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
honeycomb license#
Print Honeycomb's MIT license notice without contacting a service
Usage: honeycomb license [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb iam#
Discover the configured IAM app identity and login URL
Usage: honeycomb iam [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb login#
Exchange an IAM short-lived token, or use `login status` to check live authentication
Usage: honeycomb login [OPTIONS] <SLT_OR_STATUS>
Arguments:
<SLT_OR_STATUS>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb logout#
Revoke the IAM session and refresh family, then clear the local session
Usage: honeycomb logout [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb search#
Search public apps and private apps visible to your current memberships
Usage: honeycomb search [OPTIONS] [QUERY]
Arguments:
[QUERY] [default: ""]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--page <PAGE>
[default: 1]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb validate#
Validate honeycomb.yaml and all six required targets, or a .tar.gz archive
Usage: honeycomb validate [OPTIONS] [PATH]
Arguments:
[PATH] [default: .]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb pack#
Validate and build an immutable .tar.gz. Creates a template if honeycomb.yaml is absent
Usage: honeycomb pack [OPTIONS] [PATH]
Arguments:
[PATH] [default: .]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
-o, --output <OUTPUT>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb install#
Install the latest or selected app release for this platform. Collision errors suggest --alias
Usage: honeycomb install [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--version <VERSION>
--alias <ALIAS>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb update#
Update an installed app to its latest release, preserving aliases
Usage: honeycomb update [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb uninstall#
Uninstall only files and launchers owned by this package
Usage: honeycomb uninstall [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb installed#
Show packages installed in the selected home and testing environment
Usage: honeycomb installed [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb review#
Save a rating and review for an application you can access
Usage: honeycomb review [OPTIONS] --rating <RATING> --review <REVIEW> <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--rating <RATING>
--review <REVIEW>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb report#
Report a reproducible bug; optionally link a pull request with its fix
Usage: honeycomb report [OPTIONS] <MESSAGE>
Arguments:
<MESSAGE>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--pr <PR>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb star#
Star an application; repeat safely. Use --remove to remove the star
Usage: honeycomb star [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--remove
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps#
Create, inspect and configure organization-owned applications
Usage: honeycomb apps [OPTIONS] <COMMAND>
Commands:
upload-logo Upload a publicly viewable logo to Briefcase. Set the returned logo_url in application.json
webhook Manage pending webhook destinations and signing credentials through IAM
reconcile Refresh accepted IAM state and retry notification reconciliation
rotate-secret Replace an application's secret through IAM. Save the one-time result securely
list
get
create Submit application.json containing org_id, local_app_id, details, webhook and scopes
update Update using a complete application.json and the current revision from apps get
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps upload-logo#
Upload a publicly viewable logo to Briefcase. Set the returned logo_url in application.json
Usage: honeycomb apps upload-logo [OPTIONS] <ORG_ID> <FILE>
Arguments:
<ORG_ID>
<FILE>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps webhook#
Manage pending webhook destinations and signing credentials through IAM
Usage: honeycomb apps webhook [OPTIONS] <COMMAND>
Commands:
status Read the current pending endpoint ID and IAM revision before making a change
approve Approve the exact pending destination. Obtain application.webhook.approve step-up from IAM
rotate-secret Install a signing secret from a protected file. Update your receiver to verify it
retry Retry a saved change by operation ID; omit the secret and original endpoint
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps webhook status#
Read the current pending endpoint ID and IAM revision before making a change
Usage: honeycomb apps webhook status [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps webhook approve#
Approve the exact pending destination. Obtain application.webhook.approve step-up from IAM
Usage: honeycomb apps webhook approve [OPTIONS] --endpoint <ENDPOINT> --revision <REVISION> <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--endpoint <ENDPOINT>
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--step-up-file <STEP_UP_FILE>
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps webhook rotate-secret#
Install a signing secret from a protected file. Update your receiver to verify it
Usage: honeycomb apps webhook rotate-secret [OPTIONS] --secret-file <SECRET_FILE> --revision <REVISION> <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--secret-file <SECRET_FILE>
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--step-up-file <STEP_UP_FILE>
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps webhook retry#
Retry a saved change by operation ID; omit the secret and original endpoint
Usage: honeycomb apps webhook retry [OPTIONS] <OPERATION_ID>
Arguments:
<OPERATION_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--step-up-file <STEP_UP_FILE>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps reconcile#
Refresh accepted IAM state and retry notification reconciliation
Usage: honeycomb apps reconcile [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps rotate-secret#
Replace an application's secret through IAM. Save the one-time result securely
Usage: honeycomb apps rotate-secret [OPTIONS] --revision <REVISION> <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
--step-up-file <STEP_UP_FILE>
Read fresh IAM step-up evidence from a file, avoiding shell-history exposure
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps list#
Usage: honeycomb apps list [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--page <PAGE>
[default: 1]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps get#
Usage: honeycomb apps get [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps create#
Submit application.json containing org_id, local_app_id, details, webhook and scopes
Usage: honeycomb apps create [OPTIONS] <FILE>
Arguments:
<FILE>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb apps update#
Update using a complete application.json and the current revision from apps get
Usage: honeycomb apps update [OPTIONS] --revision <REVISION> <APP_ID> <FILE>
Arguments:
<APP_ID>
<FILE>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb releases#
Upload and inspect immutable CLI releases. Run pack before upload
Usage: honeycomb releases [OPTIONS] <COMMAND>
Commands:
list
upload
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb releases list#
Usage: honeycomb releases list [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb releases upload#
Usage: honeycomb releases upload [OPTIONS] --revision <REVISION> <APP_ID> <ARCHIVE>
Arguments:
<APP_ID>
<ARCHIVE>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication#
Request publication and participate in application review discussions
Usage: honeycomb publication [OPTIONS] <COMMAND>
Commands:
activate Activate an approved public revision and reconcile archive access
inbox Requests you can review as a provider administrator or authorized validator
review
retry-plan
decide
review-reply
get
request
reply
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication activate#
Activate an approved public revision and reconcile archive access
Usage: honeycomb publication activate [OPTIONS] --revision <REVISION> <REQUEST_ID>
Arguments:
<REQUEST_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication inbox#
Requests you can review as a provider administrator or authorized validator
Usage: honeycomb publication inbox [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication review#
Usage: honeycomb publication review [OPTIONS] <REQUEST_ID> <PROVIDER>
Arguments:
<REQUEST_ID>
<PROVIDER>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication retry-plan#
Usage: honeycomb publication retry-plan [OPTIONS] --revision <REVISION> <REQUEST_ID>
Arguments:
<REQUEST_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication decide#
Usage: honeycomb publication decide [OPTIONS] --revision <REVISION> <REQUEST_ID> <PROVIDER> <DECISION>
Arguments:
<REQUEST_ID>
<PROVIDER>
<DECISION> [possible values: approve, deny]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--reason <REASON>
[default: ""]
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication review-reply#
Usage: honeycomb publication review-reply [OPTIONS] --message <MESSAGE> <REQUEST_ID> <PROVIDER>
Arguments:
<REQUEST_ID>
<PROVIDER>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--message <MESSAGE>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication get#
Usage: honeycomb publication get [OPTIONS] <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication request#
Usage: honeycomb publication request [OPTIONS] --message <MESSAGE> --revision <REVISION> <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--message <MESSAGE>
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb publication reply#
Usage: honeycomb publication reply [OPTIONS] --message <MESSAGE> <APP_ID>
Arguments:
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--message <MESSAGE>
--provider <PROVIDER>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb drafts#
Save shared drafts with revision checks, allowing another admin to continue
Usage: honeycomb drafts [OPTIONS] <COMMAND>
Commands:
list
save
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb drafts list#
Usage: honeycomb drafts list [OPTIONS] <ORG_ID>
Arguments:
<ORG_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb drafts save#
Usage: honeycomb drafts save [OPTIONS] <ORG_ID> <ID> <FILE>
Arguments:
<ORG_ID>
<ID>
<FILE>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
[default: 0]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb operations#
Inspect pending operations or retry after repairing an integration
Usage: honeycomb operations [OPTIONS] <COMMAND>
Commands:
recover-secret Recover a creation/rotation secret within IAM's short replay window
get
retry
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb operations recover-secret#
Recover a creation/rotation secret within IAM's short replay window
Usage: honeycomb operations recover-secret [OPTIONS] <ID>
Arguments:
<ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb operations get#
Usage: honeycomb operations get [OPTIONS] <ID>
Arguments:
<ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb operations retry#
Usage: honeycomb operations retry [OPTIONS] <ID>
Arguments:
<ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments#
Create and manage isolated ecosystem testing environments
Usage: honeycomb environments [OPTIONS] <COMMAND>
Commands:
retention Inspect activity and retention deadlines without extending the idle timer
set-retention Set the shared environment idle period. App-specific longer retention still applies
activity Report actual use of an application in a ready environment; supports --test root authority
list
get
create
import Import an application's external-scope dependencies and pin accepted configurations
key Retrieve and save an environment root key. This action is audited by the backend
action Coordinate rotation, clean, delete or restore with every participating service
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments retention#
Inspect activity and retention deadlines without extending the idle timer
Usage: honeycomb environments retention [OPTIONS] <ID>
Arguments:
<ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments set-retention#
Set the shared environment idle period. App-specific longer retention still applies
Usage: honeycomb environments set-retention [OPTIONS] --days <DAYS> --revision <REVISION> <ID>
Arguments:
<ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--days <DAYS>
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments activity#
Report actual use of an application in a ready environment; supports --test root authority
Usage: honeycomb environments activity [OPTIONS] --generation <GENERATION> --key-version <KEY_VERSION> <ID> <APP_ID>
Arguments:
<ID>
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--generation <GENERATION>
--key-version <KEY_VERSION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments list#
Usage: honeycomb environments list [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments get#
Usage: honeycomb environments get [OPTIONS] <ID>
Arguments:
<ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments create#
Usage: honeycomb environments create [OPTIONS] <ORG_ID> <NAME>
Arguments:
<ORG_ID>
<NAME>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--description <DESCRIPTION>
[default: ""]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments import#
Import an application's external-scope dependencies and pin accepted configurations
Usage: honeycomb environments import [OPTIONS] --revision <REVISION> <ID> <APP_ID>
Arguments:
<ID>
<APP_ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
--release <RELEASE>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--refresh
Explicitly refresh the imported dependency graph from accepted production configurations
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments key#
Retrieve and save an environment root key. This action is audited by the backend
Usage: honeycomb environments key [OPTIONS] <ID>
Arguments:
<ID>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb environments action#
Coordinate rotation, clean, delete or restore with every participating service
Usage: honeycomb environments action [OPTIONS] --revision <REVISION> <ID> <ACTION>
Arguments:
<ID>
<ACTION> [possible values: rotate-key, clean, delete, restore, retry, purge]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--revision <REVISION>
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb config#
Configure home, backend and update/telemetry preferences
Usage: honeycomb config [OPTIONS] <COMMAND>
Commands:
home Use an existing directory as home. Data lives below <home>/.honeycomb/dir
show
env Print shell setup for this home and backend. Use eval "$(honeycomb config env)"
set Set api, auto_update or telemetry. Boolean values are true/false
help Print this message or the help of the given subcommand(s)
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb config home#
Use an existing directory as home. Data lives below <home>/.honeycomb/dir
Usage: honeycomb config home [OPTIONS] <LOCATION>
Arguments:
<LOCATION>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb config show#
Usage: honeycomb config show [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb config env#
Print shell setup for this home and backend. Use eval "$(honeycomb config env)"
Usage: honeycomb config env [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb config set#
Set api, auto_update or telemetry. Boolean values are true/false
Usage: honeycomb config set [OPTIONS] <NAME> <VALUE>
Arguments:
<NAME> [possible values: api, auto_update, telemetry]
<VALUE>
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb daemon#
Run the hourly update worker, including while no interactive commands run
Usage: honeycomb daemon [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--once
Run one scheduled check and exit, honoring auto_update
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb self-update#
Check for and install the latest verified Honeycomb CLI binary
Usage: honeycomb self-update [OPTIONS]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help
honeycomb service#
Register the per-user hourly update worker
Usage: honeycomb service [OPTIONS] <ACTION>
Arguments:
<ACTION> [possible values: install]
Options:
--api <API>
Honeycomb backend origin. HTTPS required outside localhost [env: HONEYCOMB_API_URL=]
--test <TEST>
Use a saved testing environment ID or its 32-character root key
--json
Emit structured JSON. Secrets appear only in explicit credential-returning commands
--idempotency-key <IDEMPOTENCY_KEY>
Reuse this key to safely retry a mutation after an uncertain response
-h, --help
Print help