Update a season

Rate limits

This endpoint does not belong to the priority lane. Do not use it within your ticket sales flow.

Text

POST https://api-{region}.seatsio.net/events/{seasonKey}

PHP

// updating season key
$seatsioClient->seasons->update(
  "aSeason",
  UpdateSeasonParams::create()->setKey("newSeasonKey")
);

// updating table booking config
$seatsioClient->seasons->update(
  "aSeason",
  UpdateSeasonParams::create()->setTableBookingConfig(TableBookingConfig::custom(["T1" => "BY_TABLE", "T2" => "BY_SEAT"]))
);

C#

// updating season key
await Client.Seasons.UpdateAsync("aSeason", new UpdateSeasonParams().WithKey"newSeasonKey"));

// updating table booking config
await Client.Seasons.UpdateAsync(
  "aSeason",
  new UpdateSeasonParams().WithTableBookingConfig(new Dictionary<string, string> {{"T1", "BY_TABLE"}, {"T2", "BY_SEAT"}})
);

Java

// updating season key
client.seasons.update("aSeason", new UpdateSeasonParams().withKey"newSeasonKey"));

// updating table booking config
client.seasons.update(
  "aSeason",
  new UpdateSeasonParams().withTableBookingConfig(TableBookingConfig.custom(Map.of("T1", BY_TABLE, "T2", BY_SEAT)))
);

Python

# updating season key
client.seasons.update("aSeason", event_key="newSeasonKey")

# updating table booking config
client.seasons.update("aSeason", table_booking_config=TableBookingConfig.custom({"T1": "BY_TABLE", "T2": "BY_SEAT"}))

Ruby

# updating season key
client.seasons.update key: "aSeason", event_key: "newSeasonKey"

# updating table booking config
client.seasons.update key: "aSeason", table_booking_config: Seatsio::TableBookingConfig::custom({'T1' => 'BY_TABLE', 'T2' => 'BY_SEAT'})

Javascript

// updating season key
await client.seasons.update('seasonKey', new UpdateSeasonParams().withKey('newSeasonKey'))

// updating table booking config
await client.seasons.update(
  'seasonKey',
  new UpdateSeasonParams().withTableBookingConfig(
    TableBookingConfig.custom({ T1: 'BY_TABLE', T2: 'BY_SEAT' })
  )
);

Go

// updating season key
err = client.Seasons.Update("seasonKey", &seasons.UpdateSeasonParams{EventKey: "newSeasonKey"}})

// updating table booking config
tableBookingConfig := events.TableBookingConfig{Mode: events.TableBookingSupport.Custom(), Tables: map[string]events.TableBookingMode{
    "T1": events.BY_TABLE,
	"T2": events.BY_SEAT,
}}
err = client.Seasons.Update("seasonKey", &events.UpdateSeasonParams{
    TableBookingConfig: &tableBookingConfig,
})

Request

{
  "eventKey": "newEventKey",
  "name": "new event name",
  "tableBookingConfig": {
    "mode": "CUSTOM",
    "tables": {
      "T1": "BY_TABLE",
      "T2": "BY_SEAT",
      "T3": "BY_TABLE"
    }
  },
  "objectCategories": {
    "A-1": "category1",
    "A-2": "category2"
  },
  "categories": [
    {
      'key': 'eventCategory1',
      'label': 'Event Category 1',
      'color': '#AAABBB'
    },
    {
      'key': 'eventCategory2',
      'label': 'Event Category 2',
      'color': '#CCCDDD',
      'accessible': true
    }
  ],
  "forSalePropagated": true
}

All fields are optional. If, for example, you don't specify an eventKey, the key of the season is not modified.

• objectCategories allows you to override the categorization (as defined on the chart) of specific objects. To remove overriding categorization, pass in an empty array or null. Not passing in the objectCategories field in the request will leave the objectCategories untouched.

• categories allows you to specify extra categories on the event level, not present on the chart. You can use these categories in the objectCategories map mentioned above. To remove all event-level categories, pass in an empty array or null.

Example request

curl https://api-{region}.seatsio.net/events/aSeason \
-u aSecretKey: -X POST -H 'Content-Type: application/json' -d '{"seasonKey": "4250fffc-e41f-c7cb-986a-2c5e728b8c28"}'

Example response

{
  "id": 168,
  "key": "aSeason",
  "tableBookingConfig": {
    "mode": "CUSTOM",
    "tables": {
      "T1": "BY_TABLE",
      "T2": "BY_SEAT",
      "T3": "BY_TABLE"
    }
  },
  "chartKey": "4150dddc-e41f-c7cb-986a-2c5e728b8c20",
  "supportsBestAvailable": true,
  "forSaleConfig": {
    "forSale": false,
    "objects": [
      "section1"
    ],
    "categories": []
  },
  "channels": [
    {
      "name": "Channel 1",
      "key": "8950dddc-e51f-c7cb-986a-2c5e728b8c21",
      "color": "#aaaaaa",
      "objects": [
        "A-1",
        "A-2"
      ]
    }
  ],
  "categories": [
    { "key": 1, "label": "Category 1", "color": "#aaaaaa", "accessible": true},
    { "key": 2, "label": "Category 2", "color": "#bbbbbb", "accessible":  false}
  ],
  "createdOn": "2017-03-05T10:58:44.715Z",
  "updatedOn": "2017-04-05T10:58:44.615Z",
  "events": [
    {
      "id": 170,
      "key": "event1",
      ...
    },
    ...
  ],
  "partialSeasonKeys": ["partialSeason1", "partialSeason2"],
  "isSeason": true,
  "isTopLevelSeason": true,
  "isPartialSeason": false,
  "isEventInSeason": false
}