Documentation
Sign inGet started

bird audiences update

Usage

Codebeispiel
bird audiences update <audience-id> [flags]

Description

Update an audience's name or description.
Only the fields you pass change; pass --name, --description, or both.
Build the request from flags, a JSON AudienceUpdateRequest 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

Codebeispiel
# print the body shape (no credentials needed)
bird audiences update --example

# the body it prints:
Codebeispiel
{
  "name": "Newsletter subscribers"
}
Codebeispiel
# rename an audience
bird email audiences update aud_123 --name "VIP customers"

Options

Audience

NameDescription
--nameNew display name
--descriptionNew description

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
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird audiences add-contactsAdd contacts to a static audience.
bird audiences createCreate an audience.
bird audiences deleteDelete an audience
bird audiences getGet an audience
bird audiences listList audiences
bird audiences list-contactsList an audience's contacts
bird audiences remove-contactRemove a contact from an audience
bird audiences remove-contactsRemove contacts from a static audience.