bird support-tickets create

Usage

Code example

bird support-tickets create [flags]

Opens a new ticket with the first message and returns it. Use --type support for a human request or the default --type ai for an automated answer; follow up with "bird support-tickets reply". The reply (automated or from a person, either can answer your question) arrives asynchronously, so don't drop the ticket: pass --watch to block until a reply lands, running it as a background task where your environment supports that, or wait later with "bird support-tickets get <id> --watch".

Build the request from flags, a JSON CreateSupportTicket 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 support-tickets create --example

# the body it prints:

Code example

{
  "area": "email",
  "message": "Hi, I need help setting up my sending domain.",
  "priority": "MEDIUM",
  "title": "Domain verification stuck",
  "type": "support"
}

Code example

# open a human support request
bird support-tickets create --type support --message "DKIM verification is stuck"

# preview the request without sending
bird support-tickets create --message "hi" --dry-run

Options

Ticket

Name	Description
--message	First message in the ticket
--title	Subject for the ticket; derived from the message when omitted
--type	Routing: ai (default), support, or feedback
--priority	Urgency: LOW, MEDIUM (default), HIGH, or CRITICAL

Routing

Name	Description
--area	Support team when type is "support": email, sms, whatsapp, voice, api, dashboard, billing, other
--feedback-kind	Feedback category when type is "feedback": feature-request, improvement, bug, general

Watch

Name	Description
--watch	Wait for a support agent to reply, then print the result and exit
--watch-timeout	How long --watch waits before giving up (capped at 30m) (default 5m0s)

Request

Name	Description
--body-file	Read the JSON request body from this file; "-" reads stdin
--example	Print a complete example request body, then exit
--dry-run	Print the resolved request without sending it, then exit
--idempotency-key	Deduplication key; a retry with the same key won't act twice

Options

Name	Description
--response-schema	Print the fields this command returns, then exit

Name	Description
bird support-tickets get	Get a support ticket
bird support-tickets list	List support tickets
bird support-tickets reply	Reply to an existing support ticket.
bird support-tickets viewed	Record that the authenticated user viewed a support ticket