Venues

Update a venue

Changed on

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

patch/venues/{key}

Request

  • Base URL: https://api.session.services
  • URL: https://api.session.services/venues/{key}
  • Auth: API key in header x-tenant-id

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

Public-facing description with a maximum length of 10000 characters

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-10-17T08:46:46.696Z",
    "updatedAt": "2026-10-17T08:46:46.696Z",
    "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-10-17T08:46:46.696Z",
      "updatedAt": "2026-10-17T08:46:46.696Z",
      "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

  • 84f157e4443aRevision changes
    • breaking

      the / response property's maxLength was unset from 500 for the response status

    • info

      the / request property's maxLength was increased from 500 to 10000

    • info

      added the non-success response with the status