band sip realm create

Create a SIP authentication realm

Synopsis

Creates a SIP authentication realm. The response includes the realm's generated FQDN, which is the address a SIP peer uses for outbound calls. Realm creation is asynchronous — use --wait to block until it is ACTIVE.

band sip realm create [flags]

Examples

  # Create a non-default realm and wait for it to become active
  band sip realm create --name vapi --default=false --wait

  # Idempotent create
  band sip realm create --name vapi --default=false --if-not-exists

Options

      --default              Make this the account's default realm (required — the API rejects creates without it)
      --description string   Realm description
  -h, --help                 help for create
      --if-not-exists        Return the existing realm if one with the same name and state exists
      --name string          Realm name — becomes the first label of the realm FQDN (required)
      --timeout int          Seconds to wait when --wait is set (default 60)
      --wait                 Block until the realm reaches ACTIVE

Options inherited from parent commands

      --account-id string    Bandwidth account ID (overrides config)
      --environment string   API environment: prod, test (overrides config)
      --format string        Output format: json or table (default "json")
      --plain                Simplified flat JSON output (recommended for scripts and agents)

SEE ALSO

• band sip realm - Manage SIP authentication realms