Update a channel

Update the name, color and/or assigned objects of a single channel on an event.

Text

POST https://api-{region}.seatsio.net/events/{eventKey}/channels/{channelKey}

PHP

$this->seatsioClient->events->channels->update(
    $event->key, // the event key
    "channelKey1", // the channel key
    "channel 1", // the channel name
    "#FFFF98",  // the channel color    
    ["A-1", "A-2"] // the channel objects
);

C#

await Client.Events.Channels.UpdateAsync(
    event1.Key, // the event key
    "channelKey1", // the channel key
    "channel 1", // the channel name
    "#FFFF98", // the channel color    
    new[] {"A-1", "A-2"} // the channel objects
);

Java

client.events.channels.update(
    event.key, // the event key 
    "channelKey1", // the channel key
    "channel Name 1", // the channel name
    "#00FF00", // the channel color
    Set.of("A-1", "A-2") // the channel objects
);

Python

client.events.channels.update(
    event.key, # the event key 
    'channelKey1', # the channel key
    'channel 1', # the channel name
    '#FFFF98', # the channel color    
    ['A-1', 'A-2'] # the channel objects
)

Ruby

client.events.channels.update event_key: event.key,
                              channel_key: "channelKey1",
                              channel_name: 'channel 1',
                              channel_color: "#FFFF98",
                              objects: ['A-1', 'A-2']

Javascript

await client.events.channels.update(
    event.key, // the event key
    'channelKey1', // the channel key
    'channel 1', // the channel name
    '#FFFF98', // the channel color
    ['A-1', 'A-2'] // the channel objects
)

Go

updateParams := events.UpdateChannelParams{
    Name:    "channel 1",
    Color:   "#1E1E1E",
    Objects: []string{"A-1", "A-2"},
}
err := client.Channels.Update(event.Key, "channelKey1", updateParams)

Example request body

{
    "name": "Channel 1",
    "color": "#ED303D",
    "objects": ["A-1", "A-2"]
}

The request body should be a JSON object with at least one of these properties:

• name needs to be unique across the event.
• color needs to be a valid css color; color is used in the Event Manager, to be able to distinguish different channels. End users (ticket buyers) will not get to see the channel by color.
• objects the object labels of the objects that need to be assigned to this channel. Replaces the previous list of objects.

Not specifying a property (or passing in null) in the request means its value will stay the same. That way you can use this endpoint to, for example, just update the name without touching object assignments.

Note

The specified objects will be un-assigned from any previous channels.
That means that if seat A-1 is already assigned to channelA, and you update channelB so that it gets A-1 assigned to it, it will no longer be assigned to channelA and only be assigned to channelB.

Response

204 - No Content