Prioritiesv4

Update a priority

PATCH/priorities/{priorityId}

Updates a priority's name, default flag, and/or channel set. When channels is supplied it replaces the priority's channels wholesale.

Path parameters

priorityIdRequiredstring

Unique identifier of the priority, prefixed with priority_. Returned when you create a priority or by the List priorities endpoint.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON

nameoptionalstring

is_defaultoptionalboolean

channelsoptionalstring | object[]

Array of string | object

string

object

channel_idRequiredstring

priorityoptionalinteger

Returns

dataoptionalPriority

idoptionalstring

Priority id (priority_...).

nameoptionalstring | null

is_defaultoptionalboolean

Whether this is the key's default priority (used by the agnostic send).

channelsoptionalPriorityChannel[]

Array of PriorityChannel

channel_idRequiredstring

Channel id (ch_...).

typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business"

priorityRequiredinteger

Tier (drag order). Lower runs first; same priority + same type = a pool.

created_atoptionalinteger

updated_atoptionalinteger

Response codes

200Updated priority

401Your API key is missing or invalid. Pass it as a bearer token.

404No prioritie was found with the provided `priorityId`.

422Validation failed — one or more fields in the request are invalid or missing.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X PATCH https://api.blooio.com/v4/priorities/obj_a1b2c3d4 \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "name": "Jane Doe",    "is_default": true,    "channels": [      "string"    ]  }'

Body object

{  "name": "Jane Doe",  "is_default": true,  "channels": [    "string"  ]}

Response objectexample

{  "data": {    "id": "obj_a1b2c3d4",    "name": "Jane Doe",    "is_default": true,    "channels": [      {        "channel_id": "ch_a1b2c3d4",        "type": "blooio",        "priority": 1      }    ],    "created_at": 0,    "updated_at": 0  }}