Getting started

domains

This page is the command reference for @orchestor-inc/cli.

Commands

  • orc domains list — List tracked domains
  • orc domains create — Register a tracked domain
  • orc domains get — Get a tracked domain
  • orc domains update — Update a tracked domain
  • orc domains delete — Soft-delete a tracked domain
  • orc domains verify — Trigger DNS verification for a domain
  • orc domains verification get — Get domain verification status
  • orc domains verification refresh — Recheck domain verification

orc domains list

List tracked domains

Usage

orc domains list [flags]

Flags

FlagTypeRequiredDescription
--brand-idstringNoFilter by brand.
--rolestringNoFilter by role.; enum: primary|alternate
--verification-statusstringNoenum: unverified|pending|verified|failed
--ingestion-statusstringNoenum: not_configured|configured|active|error
--limitnumberNoMaximum number of items to return
--cursorstringNoOpaque cursor for the next page

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

  • orc domain list

Help

orc domains list --help

orc domains create

Register a tracked domain

Usage

orc domains create [flags]

Flags

FlagTypeRequiredDescription
--idempotency-keystringNoUnique key for idempotent POST requests (24h TTL). If a request with the same key was already processed, the original response is returned without re-executing the operation. Reusing a key with a different request payload returns 409 idempotency_error. Use a UUID v4 or similar unique identifier.
--domainstringNo(required) Body field: domain
--brand-idstringNo(required) Body field: brand_id
--rolestringNoBody field: role; enum: primary|alternate
--verification-methodstringNoBody field: verification_method; enum: dns_txt|file_upload|manual; (use "null" or "reset" to clear)
--ingestion-methodstringNoBody field: ingestion_method; enum: log_forwarder|edge_worker|manual_upload; (use "null" or "reset" to clear)

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc domains create --help

orc domains get

Get a tracked domain

Usage

orc domains get <id> [flags]

Arguments

ArgumentRequiredDescription
idYesPath parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

  • orc domain get

Help

orc domains get --help

orc domains update

Update a tracked domain

Usage

orc domains update <id> [flags]

Arguments

ArgumentRequiredDescription
idYesPath parameter: id

Flags

FlagTypeRequiredDescription
--rolestringNoBody field: role; enum: primary|alternate
--verification-methodstringNoBody field: verification_method; enum: dns_txt|file_upload|manual; (use "null" or "reset" to clear)
--ingestion-methodstringNoBody field: ingestion_method; enum: log_forwarder|edge_worker|manual_upload; (use "null" or "reset" to clear)

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc domains update --help

orc domains delete

Soft-delete a tracked domain

Usage

orc domains delete <id> [flags]

Arguments

ArgumentRequiredDescription
idYesPath parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc domains delete --help

orc domains verify

Trigger DNS verification for a domain

Usage

orc domains verify <id> [flags]

Arguments

ArgumentRequiredDescription
idYesPath parameter: id

Flags

FlagTypeRequiredDescription
--idempotency-keystringNoUnique key for idempotent POST requests (24h TTL). If a request with the same key was already processed, the original response is returned without re-executing the operation. Reusing a key with a different request payload returns 409 idempotency_error. Use a UUID v4 or similar unique identifier.
--methodstringNoBody field: method; enum: dns_txt|file_upload|manual

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc domains verify --help

orc domains verification get

Get domain verification status

Usage

orc domains verification get <id> [flags]

Arguments

ArgumentRequiredDescription
idYesPath parameter: id

Flags

FlagTypeRequiredDescription
--idempotency-keystringNoUnique key for idempotent POST requests (24h TTL). If a request with the same key was already processed, the original response is returned without re-executing the operation. Reusing a key with a different request payload returns 409 idempotency_error. Use a UUID v4 or similar unique identifier.

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc domains verification get --help

orc domains verification refresh

Recheck domain verification

Usage

orc domains verification refresh <id> [flags]

Arguments

ArgumentRequiredDescription
idYesPath parameter: id

Flags

FlagTypeRequiredDescription
--idempotency-keystringNoUnique key for idempotent POST requests (24h TTL). If a request with the same key was already processed, the original response is returned without re-executing the operation. Reusing a key with a different request payload returns 409 idempotency_error. Use a UUID v4 or similar unique identifier.

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

  • orc domains verification recheck

Help

orc domains verification refresh --help