Release objects

Changes the object status to 'free'. Free seats are selectable on a rendered chart.

Note

releasing objects can also be used to cancel objects that are temporarily held .

POST https://api-{region}.seatsio.net/events/{eventKey}/actions/release
POST https://api-{region}.seatsio.net/events/{eventKey}/actions/release?expand=objects

Request#

{
'objects': ['A-3', 'A-5']
}
  • objects: an array of object IDs to release
  • holdToken (optional): the hold token must be supplied when you want to make sure that the same person that made the hold releases the objects.
  • channelKeys (optional): an array of strings, i.e. the channel keys of the channel(s) to which the objects belong. If omitted, and the objects to be released are assigned to a channel, the request will fail with 400 Bad request. Pass in NO_CHANNEL as channel key to allow objects without a channel.
  • ignoreChannels (optional): if true, the release call succeeds, even if the released objects belong to a channel. Useful inside a back office application, in which the user is allowed to release any seat - no matter the channel. Should not be used in combination with channelKeys.

Response#

Without expand=objects 204 - No Content

With expand=objects 200 - ok

{
"objects": {
"A-3": {
"label": "A-3",
"labels": {
"own": {
"label": "3",
"type": "seat"
},
"parent": {
"label": "Row A",
"type": "row"
},
},
"ids": {
"own": "3",
"parent": "A"
},
"status": "free",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"ticketType": "adult",
"orderId": "order1",
"forSale": true,
"objectType": "seat",
"leftNeighbour": "A-2",
"rightNeighbour": "A-4",
"entrance": "Blue"
},
"A-5": {
"label": "A-5",
"labels": {
"own": {
"label": "5",
"type": "seat"
},
"parent": {
"label": "Row A",
"type": "row"
},
},
"ids": {
"own": "5",
"parent": "A"
},
"status": "free",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"ticketType": "adult",
"orderId": "order1",
"forSale": true,
"objectType": "seat",
"leftNeighbour": "A-4",
"rightNeighbour": "A-6",
"entrance": "Blue"
}
}
}