Operation

Update Venue

PATCH/venues/{id}

Update a venue's details. Change the name, address, capacity, or other settings. Only the fields you include in the request will be updated. Changes apply to future events at this venue-existing events keep their current settings.

When to use this

Correcting a venue's address
Updating capacity after renovations
Renaming a venue

Path parameters

idstringRequired: Venue ID

Headers

Idempotency-KeystringOptional: Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.

Body

namestringVenue name

descriptionstringVenue description

status"active" | "archived"Venue status

streetAddressstringStreet address

citystringCity

countrystringCountry

coordinatesobjectnullGPS coordinates for mapping

longitude*numberLongitude (-180 to 180)

latitude*numberLatitude (-90 to 90)

timezonestringIANA timezone

phonestringnullContact phone number

emailstring,null (email)Contact email

websitestring,null (uri)Venue website

featuresstring[]Venue features and facilities

tagsstring[]Venue tags

Returns

Venue updated successfully

Errors

400: Bad Request - Invalid input
401: Unauthorized - Authentication required
403: Forbidden - Insufficient permissions
404: Not Found - Resource not found
500: Internal Server Error

Every error names its code and links to it. All error codes

Notes

Note

Updating a venue doesn't automatically update events that are already using it.

Tip

Only send the fields you want to change-omitted fields stay the same.

import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({  organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Update venueconst updated = await client.venue.update('{{VENUE_ID}}', {  name: 'Updated Name',  // Add fields to update});console.log(`Updated venue: ${updated.name}`);

Response 200

{
  "venue": {
    "id": "vnu_abc123",
    "organisationId": "org_xyz789",
    "accountId": "acc_def456",
    "name": "Royal Albert Hall",
    "description": "Historic concert hall in London",
    "status": "active",
    "streetAddress": "Kensington Gore",
    "country": "United Kingdom",
    "coordinates": {
      "type": "Point",
      "coordinates": [
        -0.1278,
        51.5074
      ]
    },
    "timezone": "Europe/London",
    "phone": "+44 20 7589 8212",
    "email": "info@royalalberthall.com",
    "website": "https://www.royalalberthall.com",
    "features": [
      "parking",
      "wheelchair_accessible",
      "bar"
    ],
    "tags": [
      "concert-hall",
      "historic"
    ],
    "isDeleted": false,
    "createdAt": "2024-12-28T10:30:00Z",
    "updatedAt": "2024-12-28T14:45:00Z",
    "createdBy": "usr_abc123"
  }
}

Update Venue

When to use this

Path parameters

Headers

Body

Returns

Errors

Notes

Related

Try it in test mode

Path parameters

Body