Sign in
Venues

Update a venue

Update an existing venue. Cannot change venue ownership (teamId)

patch/venues/{key}

Path parameters

keystring required

Venue key - either a unique ID (ven_xxx format) or URL-friendly slug

Example:ven_01jqpjksnsen9vprw95et60t2m

Request body

locationIdstring

Location identifier for this venue

googlePlaceIdstring nullable

Google Place ID. Pass null to unlink from Google Places, omit to leave unchanged.

approval'PENDING' | 'APPROVED' | 'REJECTED'

Approval status of the venue

namestring

Display name of the venue. Must be between 3 and 100 characters

slugstring

URL-friendly slug for the venue. Must be unique within tenant

descriptionstring nullable

Short description of the venue. Pass null to clear, omit to leave unchanged.

capacityinteger nullable

Maximum capacity. Pass null to clear, omit to leave unchanged.

metadataobject

Flexible key-value metadata storage for custom configuration. Similar to Stripe's metadata API. Maximum 50 keys, key names up to 40 characters, values up to 500 characters.

Example request

{
  "locationId": "loc_01h2xk3j9k8m2n5p7q9r1s3t4v",
  "approval": "APPROVED",
  "image": {
    "src": "https://assets.session.services/my-image.jpg",
    "alt": "My Image",
    "width": 1080,
    "height": 1080
  },
  "location": {
    "id": "loc_01hk153x00eh99pagyydz03sbz",
    "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
    "createdAt": "2026-08-01T15:51:39.067Z",
    "updatedAt": "2026-08-01T15:51:39.067Z",
    "name": "Watson's EQ",
    "address": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
    "city": "Moore Park",
    "state": "New South Wales",
    "postcode": "2021",
    "country": "Australia",
    "latitude": -33.8944593,
    "longitude": 151.2252255,
    "timeZone": "Australia/Sydney",
    "types": [
      "establishment",
      "point_of_interest",
      "stadium"
    ],
    "description": "Historic outdoor amphitheater known for summer concerts",
    "image": {
      "src": "https://assets.session.services/my-image.jpg",
      "alt": "My Image",
      "width": 1080,
      "height": 1080
    }
  }
}

Response

OK

Example response

{
  "venue": {
    "locationId": "loc_01h2xk3j9k8m2n5p7q9r1s3t4v",
    "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
    "approval": "APPROVED",
    "image": {
      "src": "https://assets.session.services/my-image.jpg",
      "alt": "My Image",
      "width": 1080,
      "height": 1080
    },
    "location": {
      "id": "loc_01hk153x00eh99pagyydz03sbz",
      "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
      "createdAt": "2026-08-01T15:51:39.067Z",
      "updatedAt": "2026-08-01T15:51:39.067Z",
      "name": "Watson's EQ",
      "address": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
      "city": "Moore Park",
      "state": "New South Wales",
      "postcode": "2021",
      "country": "Australia",
      "latitude": -33.8944593,
      "longitude": 151.2252255,
      "timeZone": "Australia/Sydney",
      "types": [
        "establishment",
        "point_of_interest",
        "stadium"
      ],
      "description": "Historic outdoor amphitheater known for summer concerts",
      "image": {
        "src": "https://assets.session.services/my-image.jpg",
        "alt": "My Image",
        "width": 1080,
        "height": 1080
      }
    }
  }
}

Changes