Docs
Ticketsv4

Update a ticket's status

PATCH/tickets/{ticketId}

Changes a ticket's status, for example to close a request you no longer need. Only status can change: priority is set by Blooio support and returns 422 priority_not_allowed. Purchase, system, and billing tickets are managed by Blooio and return 403. OAuth apps need tickets:write.

Path parameters

ticketIdRequiredstring

Ticket id (tkt_...), returned when the ticket is opened.

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
statusRequiredstring

open: not picked up yet. in_progress: Blooio support is working on it. waiting_on_customer: support needs a reply from you. closed: resolved.

"open""in_progress""waiting_on_customer""closed"

Returns

dataoptionalTicket
idoptionalstring

Ticket id (tkt_...).

typeoptionalstring
"purchase""purchase_failure""support""billing""technical""feature_request""call_forwarding""system"
statusoptionalstring

open: not picked up yet. in_progress: Blooio support is working on it. waiting_on_customer: support needs a reply from you. closed: resolved.

"open""in_progress""waiting_on_customer""closed"
priorityoptionalstring

Read-only. Tickets open at medium; only Blooio support changes it.

"low""medium""high""urgent"
contentoptionalstring | null

The request as it was opened.

forwardingoptionalTicketForwarding | null

Progress of a call_forwarding ticket; null for every other type.

TicketForwarding
stateoptionalstring

pending: not started yet. in_progress: Blooio is setting up forwarding with the carrier. completed: calls now forward. failed: the last attempt failed, and the ticket stays open with Blooio support. A closed ticket always reads completed.

"pending""in_progress""completed""failed"
source_numberoptionalstring | null

E.164 number whose calls are forwarded.

destination_numberoptionalstring | null

E.164 number calls are forwarded to.

completed_atoptionalinteger | null

When forwarding completed; for a ticket closed without a recorded completion, when it was closed. null until state is completed.

null
can_commentoptionalboolean

Whether this ticket type takes replies. A closed ticket also refuses them.

created_atoptionalinteger
updated_atoptionalinteger

Response codes

200The updated ticket
400The request was malformed — check the path, query parameters, and body.
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this ticket (blocked key or plan limit).
404No ticket was found with the provided `ticketId`.
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/tickets/obj_a1b2c3d4 \
Body object
Response objectexample
{  "data": {    "id": "obj_a1b2c3d4",    "type": "purchase",    "status": "open",    "priority": "low",    "content": "Hello from Blooio!",    "forwarding": {      "state": "pending",      "source_number": "string",      "destination_number": "string",      "completed_at": 0    },    "can_comment": false,    "created_at": 0,    "updated_at": 0  }}