Sign inGet Started

bird voice caller-ids verify

Usage

Code example
bird voice caller-ids verify <caller-id> [flags]

Description

Verify a caller ID
Complete a caller-ID verification challenge started in the dashboard. Recovery can place another verification call to the same number and requires the organization to remain eligible to register caller IDs. For expired or exhausted challenges, ask the user to delete and register the caller ID again in the dashboard. Read Voice destinations separately to confirm whether the number's country is enabled.
Build the request from flags, a JSON VoiceCallerIDVerifyRequest body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

Code example
# print the body shape (no credentials needed)
bird voice caller-ids verify --example

# the body it prints:
Code example
{
  "code": "123456"
}

Options

Request

NameDescription
--body-fileRead the JSON request body from this file; "-" reads stdin
--examplePrint a complete example request body, then exit
--dry-runPrint the resolved request without sending it, then exit
--idempotency-keyDeduplication key; a retry with the same key won't act twice

Options

NameDescription
--codeThe 6-digit verification code read out by the verification call. (required; or in --body-file)
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird voice caller-ids getGet a caller ID
bird voice caller-ids listList caller IDs