Cancel free tickets
Cancel a whole free order or chosen free tickets.
POST https://cotlet.dev/api/v1/billetto/orders/{order_id}/free-tickets/cancel
write Confirm
Does what Cancel all tickets and Cancel selected do on the order page: it cancels free tickets only, because paid tickets go through refund_tickets. Omit ticket_ids to cancel the whole order. Billetto's help article does not say whether the guest gets an email, so the agent tells the guest itself when you ask for that. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| order_id string required | string | Order ID from list_orders. |
| ticket_ids array | array | Ticket IDs from get_order. Omit to cancel the whole order. |
Request
curl -X POST https://cotlet.dev/api/v1/billetto/orders/order_8c41d2/free-tickets/cancel \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("billetto", "cancel_free_tickets", {"order_id":"order_8c41d2"})const result = await cotlet.call('billetto', 'cancel_free_tickets', {"order_id":"order_8c41d2"});cotlet call billetto cancel_free_tickets --data '{"order_id":"order_8c41d2"}'Example response
{
"order_id": "9041660",
"status": "cancelled",
"cancelled_tickets": [
"48377102"
]
}