Update a sales channel
Partially updates a sales channel: only the fields sent are changed, and null clears a date. The closing date must stay after the opening date once merged with the channel's current dates. Returns 404 when the channel does not exist or sells an event of another organization.
Preview release
preview release target — send Billy-API-Version: preview to reach it. Preview has no stability promise: its routes and payloads can change without notice, so pin a dated release before you depend on one. The playground below sends a real PATCH request to the live API with your own key, and will create or modify actual data.Partially updates a sales channel: only the fields sent are changed, and null clears a date. The closing date must stay after the opening date once merged with the channel's current dates. Returns 404 when the channel does not exist or sells an event of another organization.
Authorization
HTTPBearer API key authentication. Format: Bearer billy:o:<organization_id>:<api_key>
Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx
In: header
Path Parameters
Header Parameters
Requested API version. Current context: preview.
"preview"Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for PATCH /v1/sales-channels/{sales_channel_id}. An omitted field is left
unchanged.
Response Body
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/sales-channels/string" \ -H "Billy-API-Version: preview" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "5ad8d09e-c789-49e6-a8f8-1434f880beeb", "name": "Partner X", "title": "Jazz Night — tickets", "status": "DRAFT", "openingDate": "2026-11-01T10:00:00+01:00", "closingDate": "2026-12-01T23:00:00+01:00", "customerFormId": "frm_01ABCDEFGHIJKLMN", "optIns": [ { "id": "newsletter", "name": "Newsletter", "mandatory": false, "displayValues": { "fr": "Recevoir la newsletter" } } ], "offers": [ { "offerId": "331704d8-50bf-4e99-8d82-95c4974b1a2b", "type": "TICKET", "name": "Pass 2 jours", "description": "<p>Accès aux deux journées</p>", "eventId": "168c36ec-2e28-4312-be93-8893f0cc4d5e", "currency": "EUR", "images": [], "tags": [ "pass" ], "minQuantityPerOrder": 1, "maxQuantityPerOrder": 10, "compareAtPrice": 55, "createdAt": "2026-08-01T10:00:00+00:00", "vatRate": 0.2, "defaultMaximumCapacity": 500, "attendeeFormId": "5d6e7f80-9a0b-4c1d-8e2f-3a4b5c6d7e8f", "pricing": [ { "pricingId": "9f2c1b44-77aa-4f10-9c3e-0d1b2e3f4a5b", "name": "Tarif plein", "price": 45, "bundleOfferId": null, "resaleEnabled": true }, { "pricingId": "b3e7d901-1c22-4a55-8f6d-7e8f9a0b1c2d", "name": "Tarif étudiant", "price": 32, "bundleOfferId": null, "resaleEnabled": false }, { "pricingId": "c4f8ea12-2d33-4b66-9a7e-8f9a0b1c2d3e", "name": "Pass festival 3 dates", "price": 36, "bundleOfferId": "7a1b2c3d-4e5f-4061-8172-93a4b5c6d7e8", "resaleEnabled": true } ], "optionOffers": [ { "offerId": "4c5d6e7f-8091-4a2b-b3c4-d5e6f7a8b9c0", "pricingId": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9", "minQuantityPerBase": 0, "maxQuantityPerBase": 2 } ], "extras": [ { "offerId": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d", "minQuantityPerTicket": 0, "maxQuantityPerTicket": 3 } ], "minDistinctExtrasPerTicket": 0, "maxDistinctExtrasPerTicket": null, "inventory": [ { "inventoryId": "e1f2a3b4-c5d6-4e7f-8091-a2b3c4d5e6f7", "sessionId": "11223344-5566-4778-899a-bbccddeeff00", "totalStock": 500, "availableStock": 412 } ] } ], "createdAt": "2026-10-27T09:12:44.512000+00:00"}