Venues

List venues

GET/v1/teams/{teamId}/venues

Lists venue records visible to the token owner for a team.

Required scopes: venue:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

Response 200

`data`	`object[]`
`data[].officialName`	`string` Official venue name.
`data[].displayName`	`string \| null` Preferred display name shown in RoadOps.
`data[].previousNames`	`string[]` Previous or alternate venue names.
`data[].address`	`string` Venue street address or complete location address.
`data[].geo`	`object \| null` Venue geographic coordinates.
`data[].geo.latitude`	`number` Venue latitude in decimal degrees.
`data[].geo.longitude`	`number` Venue longitude in decimal degrees.
`data[].timezone`	`object \| null` IANA timezone for the venue location, such as America/New_York.
`data[].primaryContact`	`object \| null` Primary venue contact.
`data[].primaryContact.name`	`string` Contact person's name.
`data[].primaryContact.title`	`string` Contact person's role or job title.
`data[].primaryContact.phone`	`string` Contact phone number.
`data[].primaryContact.email`	`string:email` Contact email address.
`data[].primaryContact.notes`	`string` Short notes about this contact.
`data[].contacts`	`object[]` Additional venue contacts.
`data[].contacts[].name`	`string` Contact person's name.
`data[].contacts[].title`	`string` Contact person's role or job title.
`data[].contacts[].phone`	`string` Contact phone number.
`data[].contacts[].email`	`string:email` Contact email address.
`data[].contacts[].notes`	`string` Short notes about this contact.
`data[].phone`	`string \| null` Main venue phone number.
`data[].email`	`string:email` Main venue email address.
`data[].website`	`string:uri` Venue website URL.
`data[].externalRefs`	`object[]` External venue references.
`data[].externalRefs[].source`	`string` External system or reference source.
`data[].externalRefs[].value`	`string` Identifier or label from the external source.
`data[].externalRefs[].url`	`string:uri` Optional URL for the external reference.
`data[].tags`	`string[]` Venue labels used for organization.
`data[].primaryPhotoAttachmentId`	`string:uuid` Attachment ID for the venue primary photo.
`data[].notes`	`string \| null` General venue notes.
`data[].id`	`string:uuid`
`data[].orgId`	`string:uuid`
`data[].isDeleted`	`boolean`
`data[].capacity`	`object \| null` Venue capacity.
`data[].capacity.total`	`integer` Total venue capacity.
`data[].capabilities`	`object \| null` Venue capability details.
`data[].capabilities.production`	`object` Production capability details.
`data[].capabilities.production.access`	`object` Load-in and venue access details.
`data[].capabilities.production.access.description`	`string` General venue load-in description.
`data[].capabilities.production.access.dockCount`	`integer` Number of loading docks.
`data[].capabilities.production.access.shorePower`	`string` Shore power availability for buses or trucks.
`data[].capabilities.production.access.notes`	`string` Additional load-in or access notes.
`data[].capabilities.production.power`	`object` Production and shore power notes.
`data[].capabilities.production.power.show`	`object` Primary show power feed.
`data[].capabilities.production.power.show.notes`	`string` Primary show power notes.
`data[].capabilities.production.power.audio`	`object` Audio power feed.
`data[].capabilities.production.power.audio.notes`	`string` Audio power notes.
`data[].capabilities.production.power.lighting`	`object` Lighting power feed.
`data[].capabilities.production.power.lighting.notes`	`string` Lighting power notes.
`data[].capabilities.production.power.shore`	`object` Shore power feed.
`data[].capabilities.production.power.shore.notes`	`string` Shore power notes.
`data[].capabilities.production.rigging`	`object` Rigging and fly-system details.
`data[].capabilities.production.rigging.roofType`	`string` Venue roof or rigging system type.
`data[].capabilities.production.rigging.maxPointLoadLbs`	`integer` Maximum point load in pounds.
`data[].capabilities.production.rigging.flySystem`	`string` Fly system details.
`data[].capabilities.production.rigging.notes`	`string` Additional rigging notes.
`data[].capabilities.production.dimensions`	`object` Stage dimension details.
`data[].capabilities.production.dimensions.width`	`object` Usable stage width.
`data[].capabilities.production.dimensions.width.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.width.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.width.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.dimensions.depth`	`object` Usable stage depth.
`data[].capabilities.production.dimensions.depth.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.depth.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.depth.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.dimensions.height`	`object` Stage height.
`data[].capabilities.production.dimensions.height.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.height.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.height.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.dimensions.trimHeight`	`object` Trim height above the stage.
`data[].capabilities.production.dimensions.trimHeight.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.trimHeight.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.trimHeight.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.stageLayout`	`object` Stage layout details.
`data[].capabilities.production.stageLayout.wings`	`string` Stage wing space notes.
`data[].capabilities.production.stageLayout.orchestraPit`	`string` Orchestra pit details.
`data[].capabilities.production.stageLayout.barricade`	`string` Barricade setup details.
`data[].capabilities.production.stageLayout.fohPosition`	`string` Front-of-house position details.
`data[].capabilities.production.stageLayout.risers`	`string` Riser availability or layout notes.
`data[].capabilities.production.stageLayout.notes`	`string` Additional stage layout notes.
`data[].capabilities.production.climateControl`	`string` Climate control notes for the stage or venue.
`data[].capabilities.production.houseLights`	`string` House light control notes.
`data[].capabilities.production.notes`	`string` Additional production capability notes.
`data[].capabilities.equipment`	`object` Venue equipment details.
`data[].capabilities.equipment.audio`	`object` Audio equipment details.
`data[].capabilities.equipment.audio.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.audio.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.lighting`	`object` Lighting equipment details.
`data[].capabilities.equipment.lighting.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.lighting.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.video`	`object` Video equipment details.
`data[].capabilities.equipment.video.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.video.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.staging`	`object` Staging equipment details.
`data[].capabilities.equipment.staging.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.staging.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.backline`	`object` Backline equipment details.
`data[].capabilities.equipment.backline.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.backline.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.other`	`object` Other venue equipment details.
`data[].capabilities.equipment.other.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.other.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.facilities`	`object` Venue facility and hospitality details.
`data[].capabilities.facilities.dressingRooms`	`string[]` Dressing room names, counts, or notes.
`data[].capabilities.facilities.showers`	`boolean \| string` Shower availability.
`data[].capabilities.facilities.laundry`	`string` Laundry availability or instructions.
`data[].capabilities.facilities.offices`	`string` Office or production office availability.
`data[].capabilities.facilities.runners`	`string` Runner availability or notes.
`data[].capabilities.facilities.parking`	`string` General parking details.
`data[].capabilities.facilities.busParking`	`string` Bus parking details.
`data[].capabilities.facilities.truckParking`	`string` Truck parking details.
`data[].capabilities.facilities.shorePower`	`string` Shore power availability or instructions.
`data[].capabilities.facilities.towels`	`string` Towel availability or instructions.
`data[].capabilities.facilities.merch`	`string` Merchandise area or settlement notes.
`data[].capabilities.facilities.catering`	`object` Venue catering details.
`data[].capabilities.facilities.catering.breakfast`	`string` Breakfast catering notes.
`data[].capabilities.facilities.catering.lunch`	`string` Lunch catering notes.
`data[].capabilities.facilities.catering.dinner`	`string` Dinner catering notes.
`data[].capabilities.facilities.catering.location`	`string` Catering location.
`data[].capabilities.facilities.wifi`	`object` Venue Wi-Fi details.
`data[].capabilities.facilities.wifi.ssid`	`string` Venue Wi-Fi network name.
`data[].capabilities.facilities.wifi.password`	`string` Venue Wi-Fi password.
`data[].capabilities.facilities.wifi.bandwidthMbps`	`integer` Estimated Wi-Fi bandwidth in Mbps.
`data[].capabilities.facilities.wifi.notes`	`string` Additional Wi-Fi notes.
`data[].capabilities.facilities.hospitalityNotes`	`string` Additional hospitality notes.
`data[].capabilities.logistics`	`object` Venue travel and local logistics details.
`data[].capabilities.logistics.directions`	`string` Venue directions or arrival instructions.
`data[].capabilities.logistics.nearestAirports`	`string[]` Nearby airports.
`data[].capabilities.logistics.areaNotes`	`string` Additional local area notes.
`data[].capabilities.crew`	`object` Venue crew and labor details.
`data[].capabilities.crew.localUnion`	`string` Local union name or number.
`data[].capabilities.crew.penalties`	`string` Penalty, meal-break, or overtime notes.
`data[].capabilities.crew.notes`	`string` Additional crew notes.
`data[].metadata`	`object` Venue metadata.
`data[].metadata.status`	`"active"` Venue lifecycle status.
`data[].metadata.visibility`	`"org_only"` Venue visibility.
`data[].metadata.source`	`"org"` Venue source.
`data[].metadata.dataMode`	`"org_local"` Venue data mode.
`data[].metadata.orgNotes`	`string \| null` Internal team notes imported from venue tech-pack workflows.
`data[].metadata.createdAt`	`string:date-time` ISO 8601 timestamp when the venue was created.
`data[].metadata.updatedAt`	`string:date-time` ISO 8601 timestamp when the venue was last updated.
`data[].version`	`integer` Current venue aggregate version.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this venue record.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.
`meta`	`object`
`meta.cursor`	`number \| null` Highest record cursor represented by this response.

Response: List venues

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000701",
      "officialName": "Ryman Auditorium",
      "displayName": "The Ryman",
      "previousNames": [],
      "address": "116 Rep. John Lewis Way N, Nashville, TN 37219",
      "timezone": "America/Chicago",
      "capacity": {
        "total": 2362
      },
      "contacts": [],
      "externalRefs": [],
      "tags": [
        "theater"
      ],
      "notes": "Historic venue in downtown Nashville.",
      "orgId": "00000000-0000-4000-8000-000000000100",
      "metadata": {
        "status": "active",
        "visibility": "org_only",
        "source": "org",
        "dataMode": "org_local",
        "createdAt": "2026-09-01T12:00:00.000Z",
        "updatedAt": "2026-09-01T12:00:00.000Z"
      },
      "isDeleted": false,
      "version": 1,
      "cursor": 87234
    }
  ],
  "page": {
    "limit": 50,
    "nextCursor": null
  },
  "meta": {
    "cursor": 87234
  }
}

Search venues

GET/v1/teams/{teamId}/venues/search

Searches the team's local venue records.

Required scopes: venue:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`query.query`required	`string` Local venue search query. Matches the team's venue search index.
`query.limit`	`integer` Maximum number of local venue records to return. Defaults to 10 and is capped at 20.

Response 200

`data`	`object[]`
`data[].officialName`	`string` Official venue name.
`data[].displayName`	`string \| null` Preferred display name shown in RoadOps.
`data[].previousNames`	`string[]` Previous or alternate venue names.
`data[].address`	`string` Venue street address or complete location address.
`data[].geo`	`object \| null` Venue geographic coordinates.
`data[].geo.latitude`	`number` Venue latitude in decimal degrees.
`data[].geo.longitude`	`number` Venue longitude in decimal degrees.
`data[].timezone`	`object \| null` IANA timezone for the venue location, such as America/New_York.
`data[].primaryContact`	`object \| null` Primary venue contact.
`data[].primaryContact.name`	`string` Contact person's name.
`data[].primaryContact.title`	`string` Contact person's role or job title.
`data[].primaryContact.phone`	`string` Contact phone number.
`data[].primaryContact.email`	`string:email` Contact email address.
`data[].primaryContact.notes`	`string` Short notes about this contact.
`data[].contacts`	`object[]` Additional venue contacts.
`data[].contacts[].name`	`string` Contact person's name.
`data[].contacts[].title`	`string` Contact person's role or job title.
`data[].contacts[].phone`	`string` Contact phone number.
`data[].contacts[].email`	`string:email` Contact email address.
`data[].contacts[].notes`	`string` Short notes about this contact.
`data[].phone`	`string \| null` Main venue phone number.
`data[].email`	`string:email` Main venue email address.
`data[].website`	`string:uri` Venue website URL.
`data[].externalRefs`	`object[]` External venue references.
`data[].externalRefs[].source`	`string` External system or reference source.
`data[].externalRefs[].value`	`string` Identifier or label from the external source.
`data[].externalRefs[].url`	`string:uri` Optional URL for the external reference.
`data[].tags`	`string[]` Venue labels used for organization.
`data[].primaryPhotoAttachmentId`	`string:uuid` Attachment ID for the venue primary photo.
`data[].notes`	`string \| null` General venue notes.
`data[].id`	`string:uuid`
`data[].orgId`	`string:uuid`
`data[].isDeleted`	`boolean`
`data[].capacity`	`object \| null` Venue capacity.
`data[].capacity.total`	`integer` Total venue capacity.
`data[].capabilities`	`object \| null` Venue capability details.
`data[].capabilities.production`	`object` Production capability details.
`data[].capabilities.production.access`	`object` Load-in and venue access details.
`data[].capabilities.production.access.description`	`string` General venue load-in description.
`data[].capabilities.production.access.dockCount`	`integer` Number of loading docks.
`data[].capabilities.production.access.shorePower`	`string` Shore power availability for buses or trucks.
`data[].capabilities.production.access.notes`	`string` Additional load-in or access notes.
`data[].capabilities.production.power`	`object` Production and shore power notes.
`data[].capabilities.production.power.show`	`object` Primary show power feed.
`data[].capabilities.production.power.show.notes`	`string` Primary show power notes.
`data[].capabilities.production.power.audio`	`object` Audio power feed.
`data[].capabilities.production.power.audio.notes`	`string` Audio power notes.
`data[].capabilities.production.power.lighting`	`object` Lighting power feed.
`data[].capabilities.production.power.lighting.notes`	`string` Lighting power notes.
`data[].capabilities.production.power.shore`	`object` Shore power feed.
`data[].capabilities.production.power.shore.notes`	`string` Shore power notes.
`data[].capabilities.production.rigging`	`object` Rigging and fly-system details.
`data[].capabilities.production.rigging.roofType`	`string` Venue roof or rigging system type.
`data[].capabilities.production.rigging.maxPointLoadLbs`	`integer` Maximum point load in pounds.
`data[].capabilities.production.rigging.flySystem`	`string` Fly system details.
`data[].capabilities.production.rigging.notes`	`string` Additional rigging notes.
`data[].capabilities.production.dimensions`	`object` Stage dimension details.
`data[].capabilities.production.dimensions.width`	`object` Usable stage width.
`data[].capabilities.production.dimensions.width.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.width.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.width.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.dimensions.depth`	`object` Usable stage depth.
`data[].capabilities.production.dimensions.depth.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.depth.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.depth.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.dimensions.height`	`object` Stage height.
`data[].capabilities.production.dimensions.height.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.height.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.height.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.dimensions.trimHeight`	`object` Trim height above the stage.
`data[].capabilities.production.dimensions.trimHeight.value`	`number` Measured numeric value.
`data[].capabilities.production.dimensions.trimHeight.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data[].capabilities.production.dimensions.trimHeight.precision`	`integer` Number of decimal places represented by the measurement.
`data[].capabilities.production.stageLayout`	`object` Stage layout details.
`data[].capabilities.production.stageLayout.wings`	`string` Stage wing space notes.
`data[].capabilities.production.stageLayout.orchestraPit`	`string` Orchestra pit details.
`data[].capabilities.production.stageLayout.barricade`	`string` Barricade setup details.
`data[].capabilities.production.stageLayout.fohPosition`	`string` Front-of-house position details.
`data[].capabilities.production.stageLayout.risers`	`string` Riser availability or layout notes.
`data[].capabilities.production.stageLayout.notes`	`string` Additional stage layout notes.
`data[].capabilities.production.climateControl`	`string` Climate control notes for the stage or venue.
`data[].capabilities.production.houseLights`	`string` House light control notes.
`data[].capabilities.production.notes`	`string` Additional production capability notes.
`data[].capabilities.equipment`	`object` Venue equipment details.
`data[].capabilities.equipment.audio`	`object` Audio equipment details.
`data[].capabilities.equipment.audio.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.audio.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.lighting`	`object` Lighting equipment details.
`data[].capabilities.equipment.lighting.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.lighting.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.video`	`object` Video equipment details.
`data[].capabilities.equipment.video.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.video.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.staging`	`object` Staging equipment details.
`data[].capabilities.equipment.staging.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.staging.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.backline`	`object` Backline equipment details.
`data[].capabilities.equipment.backline.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.backline.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.equipment.other`	`object` Other venue equipment details.
`data[].capabilities.equipment.other.summary`	`string` Short equipment summary.
`data[].capabilities.equipment.other.inventory`	`string[]` Equipment inventory items.
`data[].capabilities.facilities`	`object` Venue facility and hospitality details.
`data[].capabilities.facilities.dressingRooms`	`string[]` Dressing room names, counts, or notes.
`data[].capabilities.facilities.showers`	`boolean \| string` Shower availability.
`data[].capabilities.facilities.laundry`	`string` Laundry availability or instructions.
`data[].capabilities.facilities.offices`	`string` Office or production office availability.
`data[].capabilities.facilities.runners`	`string` Runner availability or notes.
`data[].capabilities.facilities.parking`	`string` General parking details.
`data[].capabilities.facilities.busParking`	`string` Bus parking details.
`data[].capabilities.facilities.truckParking`	`string` Truck parking details.
`data[].capabilities.facilities.shorePower`	`string` Shore power availability or instructions.
`data[].capabilities.facilities.towels`	`string` Towel availability or instructions.
`data[].capabilities.facilities.merch`	`string` Merchandise area or settlement notes.
`data[].capabilities.facilities.catering`	`object` Venue catering details.
`data[].capabilities.facilities.catering.breakfast`	`string` Breakfast catering notes.
`data[].capabilities.facilities.catering.lunch`	`string` Lunch catering notes.
`data[].capabilities.facilities.catering.dinner`	`string` Dinner catering notes.
`data[].capabilities.facilities.catering.location`	`string` Catering location.
`data[].capabilities.facilities.wifi`	`object` Venue Wi-Fi details.
`data[].capabilities.facilities.wifi.ssid`	`string` Venue Wi-Fi network name.
`data[].capabilities.facilities.wifi.password`	`string` Venue Wi-Fi password.
`data[].capabilities.facilities.wifi.bandwidthMbps`	`integer` Estimated Wi-Fi bandwidth in Mbps.
`data[].capabilities.facilities.wifi.notes`	`string` Additional Wi-Fi notes.
`data[].capabilities.facilities.hospitalityNotes`	`string` Additional hospitality notes.
`data[].capabilities.logistics`	`object` Venue travel and local logistics details.
`data[].capabilities.logistics.directions`	`string` Venue directions or arrival instructions.
`data[].capabilities.logistics.nearestAirports`	`string[]` Nearby airports.
`data[].capabilities.logistics.areaNotes`	`string` Additional local area notes.
`data[].capabilities.crew`	`object` Venue crew and labor details.
`data[].capabilities.crew.localUnion`	`string` Local union name or number.
`data[].capabilities.crew.penalties`	`string` Penalty, meal-break, or overtime notes.
`data[].capabilities.crew.notes`	`string` Additional crew notes.
`data[].metadata`	`object` Venue metadata.
`data[].metadata.status`	`"active"` Venue lifecycle status.
`data[].metadata.visibility`	`"org_only"` Venue visibility.
`data[].metadata.source`	`"org"` Venue source.
`data[].metadata.dataMode`	`"org_local"` Venue data mode.
`data[].metadata.orgNotes`	`string \| null` Internal team notes imported from venue tech-pack workflows.
`data[].metadata.createdAt`	`string:date-time` ISO 8601 timestamp when the venue was created.
`data[].metadata.updatedAt`	`string:date-time` ISO 8601 timestamp when the venue was last updated.
`data[].version`	`integer` Current venue aggregate version.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this venue record.
`meta`	`object`
`meta.query`	`string` Search query used for the local venue lookup.
`meta.cursor`	`number \| null` Highest record cursor represented by this response.

Response: Search venues

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000701",
      "officialName": "Ryman Auditorium",
      "displayName": "The Ryman",
      "previousNames": [],
      "address": "116 Rep. John Lewis Way N, Nashville, TN 37219",
      "timezone": "America/Chicago",
      "capacity": {
        "total": 2362
      },
      "contacts": [],
      "externalRefs": [],
      "tags": [
        "theater"
      ],
      "notes": "Historic venue in downtown Nashville.",
      "orgId": "00000000-0000-4000-8000-000000000100",
      "metadata": {
        "status": "active",
        "visibility": "org_only",
        "source": "org",
        "dataMode": "org_local",
        "createdAt": "2026-09-01T12:00:00.000Z",
        "updatedAt": "2026-09-01T12:00:00.000Z"
      },
      "isDeleted": false,
      "version": 1,
      "cursor": 87234
    }
  ],
  "meta": {
    "query": "ryman",
    "cursor": 87234
  }
}

Create a venue

POST/v1/teams/{teamId}/venues

Accepts a command to create a venue for a team.

Required scopes: venue:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`officialName`required	`string` Official venue name.
`displayName`	`string \| null` Preferred display name shown in RoadOps.
`previousNames`required	`string[]` Previous or alternate venue names.
`address`required	`string` Venue street address or complete location address.
`geo`	`object \| null` Venue geographic coordinates.
`geo.latitude`required	`number` Venue latitude in decimal degrees.
`geo.longitude`required	`number` Venue longitude in decimal degrees.
`timezone`	`object \| null` IANA timezone for the venue location, such as America/New_York.
`primaryContact`	`object \| null` Primary venue contact.
`primaryContact.name`required	`string` Contact person's name.
`primaryContact.title`	`string` Contact person's role or job title.
`primaryContact.phone`	`string` Contact phone number.
`primaryContact.email`	`string:email` Contact email address.
`primaryContact.notes`	`string` Short notes about this contact.
`contacts`required	`object[]` Additional venue contacts.
`contacts[].name`required	`string` Contact person's name.
`contacts[].title`	`string` Contact person's role or job title.
`contacts[].phone`	`string` Contact phone number.
`contacts[].email`	`string:email` Contact email address.
`contacts[].notes`	`string` Short notes about this contact.
`phone`	`string \| null` Main venue phone number.
`email`	`string:email` Main venue email address.
`website`	`string:uri` Venue website URL.
`externalRefs`required	`object[]` External venue references.
`externalRefs[].source`required	`string` External system or reference source.
`externalRefs[].value`required	`string` Identifier or label from the external source.
`externalRefs[].url`	`string:uri` Optional URL for the external reference.
`tags`required	`string[]` Venue labels used for organization.
`primaryPhotoAttachmentId`	`string:uuid` Attachment ID for the venue primary photo.
`notes`	`string \| null` General venue notes.
`capacity`	`object \| null` Venue capacity.
`capacity.total`required	`integer` Total venue capacity.
`capabilities`	`object \| null` Venue capability details.
`capabilities.production`	`object` Production capability details.
`capabilities.production.access`	`object` Load-in and venue access details.
`capabilities.production.access.description`	`string` General venue load-in description.
`capabilities.production.access.dockCount`	`integer` Number of loading docks.
`capabilities.production.access.shorePower`	`string` Shore power availability for buses or trucks.
`capabilities.production.access.notes`	`string` Additional load-in or access notes.
`capabilities.production.power`	`object` Production and shore power notes.
`capabilities.production.power.show`	`object` Primary show power feed.
`capabilities.production.power.show.notes`	`string` Primary show power notes.
`capabilities.production.power.audio`	`object` Audio power feed.
`capabilities.production.power.audio.notes`	`string` Audio power notes.
`capabilities.production.power.lighting`	`object` Lighting power feed.
`capabilities.production.power.lighting.notes`	`string` Lighting power notes.
`capabilities.production.power.shore`	`object` Shore power feed.
`capabilities.production.power.shore.notes`	`string` Shore power notes.
`capabilities.production.rigging`	`object` Rigging and fly-system details.
`capabilities.production.rigging.roofType`	`string` Venue roof or rigging system type.
`capabilities.production.rigging.maxPointLoadLbs`	`integer` Maximum point load in pounds.
`capabilities.production.rigging.flySystem`	`string` Fly system details.
`capabilities.production.rigging.notes`	`string` Additional rigging notes.
`capabilities.production.dimensions`	`object` Stage dimension details.
`capabilities.production.dimensions.width`	`object` Usable stage width.
`capabilities.production.dimensions.width.value`required	`number` Measured numeric value.
`capabilities.production.dimensions.width.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`capabilities.production.dimensions.width.precision`	`integer` Number of decimal places represented by the measurement.
`capabilities.production.dimensions.depth`	`object` Usable stage depth.
`capabilities.production.dimensions.depth.value`required	`number` Measured numeric value.
`capabilities.production.dimensions.depth.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`capabilities.production.dimensions.depth.precision`	`integer` Number of decimal places represented by the measurement.
`capabilities.production.dimensions.height`	`object` Stage height.
`capabilities.production.dimensions.height.value`required	`number` Measured numeric value.
`capabilities.production.dimensions.height.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`capabilities.production.dimensions.height.precision`	`integer` Number of decimal places represented by the measurement.
`capabilities.production.dimensions.trimHeight`	`object` Trim height above the stage.
`capabilities.production.dimensions.trimHeight.value`required	`number` Measured numeric value.
`capabilities.production.dimensions.trimHeight.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`capabilities.production.dimensions.trimHeight.precision`	`integer` Number of decimal places represented by the measurement.
`capabilities.production.stageLayout`	`object` Stage layout details.
`capabilities.production.stageLayout.wings`	`string` Stage wing space notes.
`capabilities.production.stageLayout.orchestraPit`	`string` Orchestra pit details.
`capabilities.production.stageLayout.barricade`	`string` Barricade setup details.
`capabilities.production.stageLayout.fohPosition`	`string` Front-of-house position details.
`capabilities.production.stageLayout.risers`	`string` Riser availability or layout notes.
`capabilities.production.stageLayout.notes`	`string` Additional stage layout notes.
`capabilities.production.climateControl`	`string` Climate control notes for the stage or venue.
`capabilities.production.houseLights`	`string` House light control notes.
`capabilities.production.notes`	`string` Additional production capability notes.
`capabilities.equipment`	`object` Venue equipment details.
`capabilities.equipment.audio`	`object` Audio equipment details.
`capabilities.equipment.audio.summary`	`string` Short equipment summary.
`capabilities.equipment.audio.inventory`required	`string[]` Equipment inventory items.
`capabilities.equipment.lighting`	`object` Lighting equipment details.
`capabilities.equipment.lighting.summary`	`string` Short equipment summary.
`capabilities.equipment.lighting.inventory`required	`string[]` Equipment inventory items.
`capabilities.equipment.video`	`object` Video equipment details.
`capabilities.equipment.video.summary`	`string` Short equipment summary.
`capabilities.equipment.video.inventory`required	`string[]` Equipment inventory items.
`capabilities.equipment.staging`	`object` Staging equipment details.
`capabilities.equipment.staging.summary`	`string` Short equipment summary.
`capabilities.equipment.staging.inventory`required	`string[]` Equipment inventory items.
`capabilities.equipment.backline`	`object` Backline equipment details.
`capabilities.equipment.backline.summary`	`string` Short equipment summary.
`capabilities.equipment.backline.inventory`required	`string[]` Equipment inventory items.
`capabilities.equipment.other`	`object` Other venue equipment details.
`capabilities.equipment.other.summary`	`string` Short equipment summary.
`capabilities.equipment.other.inventory`required	`string[]` Equipment inventory items.
`capabilities.facilities`	`object` Venue facility and hospitality details.
`capabilities.facilities.dressingRooms`	`string[]` Dressing room names, counts, or notes.
`capabilities.facilities.showers`	`boolean \| string` Shower availability.
`capabilities.facilities.laundry`	`string` Laundry availability or instructions.
`capabilities.facilities.offices`	`string` Office or production office availability.
`capabilities.facilities.runners`	`string` Runner availability or notes.
`capabilities.facilities.parking`	`string` General parking details.
`capabilities.facilities.busParking`	`string` Bus parking details.
`capabilities.facilities.truckParking`	`string` Truck parking details.
`capabilities.facilities.shorePower`	`string` Shore power availability or instructions.
`capabilities.facilities.towels`	`string` Towel availability or instructions.
`capabilities.facilities.merch`	`string` Merchandise area or settlement notes.
`capabilities.facilities.catering`	`object` Venue catering details.
`capabilities.facilities.catering.breakfast`	`string` Breakfast catering notes.
`capabilities.facilities.catering.lunch`	`string` Lunch catering notes.
`capabilities.facilities.catering.dinner`	`string` Dinner catering notes.
`capabilities.facilities.catering.location`	`string` Catering location.
`capabilities.facilities.wifi`	`object` Venue Wi-Fi details.
`capabilities.facilities.wifi.ssid`	`string` Venue Wi-Fi network name.
`capabilities.facilities.wifi.password`	`string` Venue Wi-Fi password.
`capabilities.facilities.wifi.bandwidthMbps`	`integer` Estimated Wi-Fi bandwidth in Mbps.
`capabilities.facilities.wifi.notes`	`string` Additional Wi-Fi notes.
`capabilities.facilities.hospitalityNotes`	`string` Additional hospitality notes.
`capabilities.logistics`	`object` Venue travel and local logistics details.
`capabilities.logistics.directions`	`string` Venue directions or arrival instructions.
`capabilities.logistics.nearestAirports`	`string[]` Nearby airports.
`capabilities.logistics.areaNotes`	`string` Additional local area notes.
`capabilities.crew`	`object` Venue crew and labor details.
`capabilities.crew.localUnion`	`string` Local union name or number.
`capabilities.crew.penalties`	`string` Penalty, meal-break, or overtime notes.
`capabilities.crew.notes`	`string` Additional crew notes.
`id`	`string:uuid` Optional caller-supplied venue ID. RoadOps generates one when omitted.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Retrieve a venue

GET/v1/teams/{teamId}/venues/{venueId}

Returns one venue record by ID.

Required scopes: venue:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.venueId`required	`string:uuid` Venue identifier.

Response 200

`data`	`object`
`data.officialName`	`string` Official venue name.
`data.displayName`	`string \| null` Preferred display name shown in RoadOps.
`data.previousNames`	`string[]` Previous or alternate venue names.
`data.address`	`string` Venue street address or complete location address.
`data.geo`	`object \| null` Venue geographic coordinates.
`data.geo.latitude`	`number` Venue latitude in decimal degrees.
`data.geo.longitude`	`number` Venue longitude in decimal degrees.
`data.timezone`	`object \| null` IANA timezone for the venue location, such as America/New_York.
`data.primaryContact`	`object \| null` Primary venue contact.
`data.primaryContact.name`	`string` Contact person's name.
`data.primaryContact.title`	`string` Contact person's role or job title.
`data.primaryContact.phone`	`string` Contact phone number.
`data.primaryContact.email`	`string:email` Contact email address.
`data.primaryContact.notes`	`string` Short notes about this contact.
`data.contacts`	`object[]` Additional venue contacts.
`data.contacts[].name`	`string` Contact person's name.
`data.contacts[].title`	`string` Contact person's role or job title.
`data.contacts[].phone`	`string` Contact phone number.
`data.contacts[].email`	`string:email` Contact email address.
`data.contacts[].notes`	`string` Short notes about this contact.
`data.phone`	`string \| null` Main venue phone number.
`data.email`	`string:email` Main venue email address.
`data.website`	`string:uri` Venue website URL.
`data.externalRefs`	`object[]` External venue references.
`data.externalRefs[].source`	`string` External system or reference source.
`data.externalRefs[].value`	`string` Identifier or label from the external source.
`data.externalRefs[].url`	`string:uri` Optional URL for the external reference.
`data.tags`	`string[]` Venue labels used for organization.
`data.primaryPhotoAttachmentId`	`string:uuid` Attachment ID for the venue primary photo.
`data.notes`	`string \| null` General venue notes.
`data.id`	`string:uuid`
`data.orgId`	`string:uuid`
`data.isDeleted`	`boolean`
`data.capacity`	`object \| null` Venue capacity.
`data.capacity.total`	`integer` Total venue capacity.
`data.capabilities`	`object \| null` Venue capability details.
`data.capabilities.production`	`object` Production capability details.
`data.capabilities.production.access`	`object` Load-in and venue access details.
`data.capabilities.production.access.description`	`string` General venue load-in description.
`data.capabilities.production.access.dockCount`	`integer` Number of loading docks.
`data.capabilities.production.access.shorePower`	`string` Shore power availability for buses or trucks.
`data.capabilities.production.access.notes`	`string` Additional load-in or access notes.
`data.capabilities.production.power`	`object` Production and shore power notes.
`data.capabilities.production.power.show`	`object` Primary show power feed.
`data.capabilities.production.power.show.notes`	`string` Primary show power notes.
`data.capabilities.production.power.audio`	`object` Audio power feed.
`data.capabilities.production.power.audio.notes`	`string` Audio power notes.
`data.capabilities.production.power.lighting`	`object` Lighting power feed.
`data.capabilities.production.power.lighting.notes`	`string` Lighting power notes.
`data.capabilities.production.power.shore`	`object` Shore power feed.
`data.capabilities.production.power.shore.notes`	`string` Shore power notes.
`data.capabilities.production.rigging`	`object` Rigging and fly-system details.
`data.capabilities.production.rigging.roofType`	`string` Venue roof or rigging system type.
`data.capabilities.production.rigging.maxPointLoadLbs`	`integer` Maximum point load in pounds.
`data.capabilities.production.rigging.flySystem`	`string` Fly system details.
`data.capabilities.production.rigging.notes`	`string` Additional rigging notes.
`data.capabilities.production.dimensions`	`object` Stage dimension details.
`data.capabilities.production.dimensions.width`	`object` Usable stage width.
`data.capabilities.production.dimensions.width.value`	`number` Measured numeric value.
`data.capabilities.production.dimensions.width.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.width.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.dimensions.depth`	`object` Usable stage depth.
`data.capabilities.production.dimensions.depth.value`	`number` Measured numeric value.
`data.capabilities.production.dimensions.depth.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.depth.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.dimensions.height`	`object` Stage height.
`data.capabilities.production.dimensions.height.value`	`number` Measured numeric value.
`data.capabilities.production.dimensions.height.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.height.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.dimensions.trimHeight`	`object` Trim height above the stage.
`data.capabilities.production.dimensions.trimHeight.value`	`number` Measured numeric value.
`data.capabilities.production.dimensions.trimHeight.unit`	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.trimHeight.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.stageLayout`	`object` Stage layout details.
`data.capabilities.production.stageLayout.wings`	`string` Stage wing space notes.
`data.capabilities.production.stageLayout.orchestraPit`	`string` Orchestra pit details.
`data.capabilities.production.stageLayout.barricade`	`string` Barricade setup details.
`data.capabilities.production.stageLayout.fohPosition`	`string` Front-of-house position details.
`data.capabilities.production.stageLayout.risers`	`string` Riser availability or layout notes.
`data.capabilities.production.stageLayout.notes`	`string` Additional stage layout notes.
`data.capabilities.production.climateControl`	`string` Climate control notes for the stage or venue.
`data.capabilities.production.houseLights`	`string` House light control notes.
`data.capabilities.production.notes`	`string` Additional production capability notes.
`data.capabilities.equipment`	`object` Venue equipment details.
`data.capabilities.equipment.audio`	`object` Audio equipment details.
`data.capabilities.equipment.audio.summary`	`string` Short equipment summary.
`data.capabilities.equipment.audio.inventory`	`string[]` Equipment inventory items.
`data.capabilities.equipment.lighting`	`object` Lighting equipment details.
`data.capabilities.equipment.lighting.summary`	`string` Short equipment summary.
`data.capabilities.equipment.lighting.inventory`	`string[]` Equipment inventory items.
`data.capabilities.equipment.video`	`object` Video equipment details.
`data.capabilities.equipment.video.summary`	`string` Short equipment summary.
`data.capabilities.equipment.video.inventory`	`string[]` Equipment inventory items.
`data.capabilities.equipment.staging`	`object` Staging equipment details.
`data.capabilities.equipment.staging.summary`	`string` Short equipment summary.
`data.capabilities.equipment.staging.inventory`	`string[]` Equipment inventory items.
`data.capabilities.equipment.backline`	`object` Backline equipment details.
`data.capabilities.equipment.backline.summary`	`string` Short equipment summary.
`data.capabilities.equipment.backline.inventory`	`string[]` Equipment inventory items.
`data.capabilities.equipment.other`	`object` Other venue equipment details.
`data.capabilities.equipment.other.summary`	`string` Short equipment summary.
`data.capabilities.equipment.other.inventory`	`string[]` Equipment inventory items.
`data.capabilities.facilities`	`object` Venue facility and hospitality details.
`data.capabilities.facilities.dressingRooms`	`string[]` Dressing room names, counts, or notes.
`data.capabilities.facilities.showers`	`boolean \| string` Shower availability.
`data.capabilities.facilities.laundry`	`string` Laundry availability or instructions.
`data.capabilities.facilities.offices`	`string` Office or production office availability.
`data.capabilities.facilities.runners`	`string` Runner availability or notes.
`data.capabilities.facilities.parking`	`string` General parking details.
`data.capabilities.facilities.busParking`	`string` Bus parking details.
`data.capabilities.facilities.truckParking`	`string` Truck parking details.
`data.capabilities.facilities.shorePower`	`string` Shore power availability or instructions.
`data.capabilities.facilities.towels`	`string` Towel availability or instructions.
`data.capabilities.facilities.merch`	`string` Merchandise area or settlement notes.
`data.capabilities.facilities.catering`	`object` Venue catering details.
`data.capabilities.facilities.catering.breakfast`	`string` Breakfast catering notes.
`data.capabilities.facilities.catering.lunch`	`string` Lunch catering notes.
`data.capabilities.facilities.catering.dinner`	`string` Dinner catering notes.
`data.capabilities.facilities.catering.location`	`string` Catering location.
`data.capabilities.facilities.wifi`	`object` Venue Wi-Fi details.
`data.capabilities.facilities.wifi.ssid`	`string` Venue Wi-Fi network name.
`data.capabilities.facilities.wifi.password`	`string` Venue Wi-Fi password.
`data.capabilities.facilities.wifi.bandwidthMbps`	`integer` Estimated Wi-Fi bandwidth in Mbps.
`data.capabilities.facilities.wifi.notes`	`string` Additional Wi-Fi notes.
`data.capabilities.facilities.hospitalityNotes`	`string` Additional hospitality notes.
`data.capabilities.logistics`	`object` Venue travel and local logistics details.
`data.capabilities.logistics.directions`	`string` Venue directions or arrival instructions.
`data.capabilities.logistics.nearestAirports`	`string[]` Nearby airports.
`data.capabilities.logistics.areaNotes`	`string` Additional local area notes.
`data.capabilities.crew`	`object` Venue crew and labor details.
`data.capabilities.crew.localUnion`	`string` Local union name or number.
`data.capabilities.crew.penalties`	`string` Penalty, meal-break, or overtime notes.
`data.capabilities.crew.notes`	`string` Additional crew notes.
`data.metadata`	`object` Venue metadata.
`data.metadata.status`	`"active"` Venue lifecycle status.
`data.metadata.visibility`	`"org_only"` Venue visibility.
`data.metadata.source`	`"org"` Venue source.
`data.metadata.dataMode`	`"org_local"` Venue data mode.
`data.metadata.orgNotes`	`string \| null` Internal team notes imported from venue tech-pack workflows.
`data.metadata.createdAt`	`string:date-time` ISO 8601 timestamp when the venue was created.
`data.metadata.updatedAt`	`string:date-time` ISO 8601 timestamp when the venue was last updated.
`data.version`	`integer` Current venue aggregate version.
`data.cursor`	`integer` Latest event-ledger cursor projected into this venue record.
`meta`	`object`
`meta.cursor`	`integer` Highest record cursor represented by this response.

Response: Retrieve venue

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000701",
    "officialName": "Ryman Auditorium",
    "displayName": "The Ryman",
    "previousNames": [],
    "address": "116 Rep. John Lewis Way N, Nashville, TN 37219",
    "timezone": "America/Chicago",
    "capacity": {
      "total": 2362
    },
    "contacts": [],
    "externalRefs": [],
    "tags": [
      "theater"
    ],
    "notes": "Historic venue in downtown Nashville.",
    "orgId": "00000000-0000-4000-8000-000000000100",
    "metadata": {
      "status": "active",
      "visibility": "org_only",
      "source": "org",
      "dataMode": "org_local",
      "createdAt": "2026-09-01T12:00:00.000Z",
      "updatedAt": "2026-09-01T12:00:00.000Z"
    },
    "isDeleted": false,
    "version": 1,
    "cursor": 87234
  },
  "meta": {
    "cursor": 87234
  }
}

Update a venue

PATCH/v1/teams/{teamId}/venues/{venueId}

Accepts a command to update venue profile fields.

Required scopes: venue:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.venueId`required	`string:uuid` Venue identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`expectedVersion`	`integer` Optional aggregate version guard.
`data`	`object` Venue profile fields to update.
`data.officialName`	`string` Official venue name.
`data.displayName`	`string \| null` Preferred display name shown in RoadOps.
`data.previousNames`	`string[]` Previous or alternate venue names.
`data.address`	`string` Venue street address or complete location address.
`data.geo`	`object \| null` Venue geographic coordinates.
`data.geo.latitude`required	`number` Venue latitude in decimal degrees.
`data.geo.longitude`required	`number` Venue longitude in decimal degrees.
`data.timezone`	`object \| null` IANA timezone for the venue location, such as America/New_York.
`data.primaryContact`	`object \| null` Primary venue contact.
`data.primaryContact.name`required	`string` Contact person's name.
`data.primaryContact.title`	`string` Contact person's role or job title.
`data.primaryContact.phone`	`string` Contact phone number.
`data.primaryContact.email`	`string:email` Contact email address.
`data.primaryContact.notes`	`string` Short notes about this contact.
`data.contacts`	`object[]` Additional venue contacts.
`data.contacts[].name`required	`string` Contact person's name.
`data.contacts[].title`	`string` Contact person's role or job title.
`data.contacts[].phone`	`string` Contact phone number.
`data.contacts[].email`	`string:email` Contact email address.
`data.contacts[].notes`	`string` Short notes about this contact.
`data.phone`	`string \| null` Main venue phone number.
`data.email`	`string:email` Main venue email address.
`data.website`	`string:uri` Venue website URL.
`data.externalRefs`	`object[]` External venue references.
`data.externalRefs[].source`required	`string` External system or reference source.
`data.externalRefs[].value`required	`string` Identifier or label from the external source.
`data.externalRefs[].url`	`string:uri` Optional URL for the external reference.
`data.tags`	`string[]` Venue labels used for organization.
`data.primaryPhotoAttachmentId`	`string:uuid` Attachment ID for the venue primary photo.
`data.notes`	`string \| null` General venue notes.
`data.capacity`	`object \| null` Venue capacity.
`data.capacity.total`required	`integer` Total venue capacity.
`data.capabilities`	`object \| null` Venue capability details.
`data.capabilities.production`	`object` Production capability details.
`data.capabilities.production.access`	`object` Load-in and venue access details.
`data.capabilities.production.access.description`	`string` General venue load-in description.
`data.capabilities.production.access.dockCount`	`integer` Number of loading docks.
`data.capabilities.production.access.shorePower`	`string` Shore power availability for buses or trucks.
`data.capabilities.production.access.notes`	`string` Additional load-in or access notes.
`data.capabilities.production.power`	`object` Production and shore power notes.
`data.capabilities.production.power.show`	`object` Primary show power feed.
`data.capabilities.production.power.show.notes`	`string` Primary show power notes.
`data.capabilities.production.power.audio`	`object` Audio power feed.
`data.capabilities.production.power.audio.notes`	`string` Audio power notes.
`data.capabilities.production.power.lighting`	`object` Lighting power feed.
`data.capabilities.production.power.lighting.notes`	`string` Lighting power notes.
`data.capabilities.production.power.shore`	`object` Shore power feed.
`data.capabilities.production.power.shore.notes`	`string` Shore power notes.
`data.capabilities.production.rigging`	`object` Rigging and fly-system details.
`data.capabilities.production.rigging.roofType`	`string` Venue roof or rigging system type.
`data.capabilities.production.rigging.maxPointLoadLbs`	`integer` Maximum point load in pounds.
`data.capabilities.production.rigging.flySystem`	`string` Fly system details.
`data.capabilities.production.rigging.notes`	`string` Additional rigging notes.
`data.capabilities.production.dimensions`	`object` Stage dimension details.
`data.capabilities.production.dimensions.width`	`object` Usable stage width.
`data.capabilities.production.dimensions.width.value`required	`number` Measured numeric value.
`data.capabilities.production.dimensions.width.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.width.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.dimensions.depth`	`object` Usable stage depth.
`data.capabilities.production.dimensions.depth.value`required	`number` Measured numeric value.
`data.capabilities.production.dimensions.depth.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.depth.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.dimensions.height`	`object` Stage height.
`data.capabilities.production.dimensions.height.value`required	`number` Measured numeric value.
`data.capabilities.production.dimensions.height.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.height.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.dimensions.trimHeight`	`object` Trim height above the stage.
`data.capabilities.production.dimensions.trimHeight.value`required	`number` Measured numeric value.
`data.capabilities.production.dimensions.trimHeight.unit`required	`"ft" \| "m" \| "in" \| "cm"` Measurement unit for the value.
`data.capabilities.production.dimensions.trimHeight.precision`	`integer` Number of decimal places represented by the measurement.
`data.capabilities.production.stageLayout`	`object` Stage layout details.
`data.capabilities.production.stageLayout.wings`	`string` Stage wing space notes.
`data.capabilities.production.stageLayout.orchestraPit`	`string` Orchestra pit details.
`data.capabilities.production.stageLayout.barricade`	`string` Barricade setup details.
`data.capabilities.production.stageLayout.fohPosition`	`string` Front-of-house position details.
`data.capabilities.production.stageLayout.risers`	`string` Riser availability or layout notes.
`data.capabilities.production.stageLayout.notes`	`string` Additional stage layout notes.
`data.capabilities.production.climateControl`	`string` Climate control notes for the stage or venue.
`data.capabilities.production.houseLights`	`string` House light control notes.
`data.capabilities.production.notes`	`string` Additional production capability notes.
`data.capabilities.equipment`	`object` Venue equipment details.
`data.capabilities.equipment.audio`	`object` Audio equipment details.
`data.capabilities.equipment.audio.summary`	`string` Short equipment summary.
`data.capabilities.equipment.audio.inventory`required	`string[]` Equipment inventory items.
`data.capabilities.equipment.lighting`	`object` Lighting equipment details.
`data.capabilities.equipment.lighting.summary`	`string` Short equipment summary.
`data.capabilities.equipment.lighting.inventory`required	`string[]` Equipment inventory items.
`data.capabilities.equipment.video`	`object` Video equipment details.
`data.capabilities.equipment.video.summary`	`string` Short equipment summary.
`data.capabilities.equipment.video.inventory`required	`string[]` Equipment inventory items.
`data.capabilities.equipment.staging`	`object` Staging equipment details.
`data.capabilities.equipment.staging.summary`	`string` Short equipment summary.
`data.capabilities.equipment.staging.inventory`required	`string[]` Equipment inventory items.
`data.capabilities.equipment.backline`	`object` Backline equipment details.
`data.capabilities.equipment.backline.summary`	`string` Short equipment summary.
`data.capabilities.equipment.backline.inventory`required	`string[]` Equipment inventory items.
`data.capabilities.equipment.other`	`object` Other venue equipment details.
`data.capabilities.equipment.other.summary`	`string` Short equipment summary.
`data.capabilities.equipment.other.inventory`required	`string[]` Equipment inventory items.
`data.capabilities.facilities`	`object` Venue facility and hospitality details.
`data.capabilities.facilities.dressingRooms`	`string[]` Dressing room names, counts, or notes.
`data.capabilities.facilities.showers`	`boolean \| string` Shower availability.
`data.capabilities.facilities.laundry`	`string` Laundry availability or instructions.
`data.capabilities.facilities.offices`	`string` Office or production office availability.
`data.capabilities.facilities.runners`	`string` Runner availability or notes.
`data.capabilities.facilities.parking`	`string` General parking details.
`data.capabilities.facilities.busParking`	`string` Bus parking details.
`data.capabilities.facilities.truckParking`	`string` Truck parking details.
`data.capabilities.facilities.shorePower`	`string` Shore power availability or instructions.
`data.capabilities.facilities.towels`	`string` Towel availability or instructions.
`data.capabilities.facilities.merch`	`string` Merchandise area or settlement notes.
`data.capabilities.facilities.catering`	`object` Venue catering details.
`data.capabilities.facilities.catering.breakfast`	`string` Breakfast catering notes.
`data.capabilities.facilities.catering.lunch`	`string` Lunch catering notes.
`data.capabilities.facilities.catering.dinner`	`string` Dinner catering notes.
`data.capabilities.facilities.catering.location`	`string` Catering location.
`data.capabilities.facilities.wifi`	`object` Venue Wi-Fi details.
`data.capabilities.facilities.wifi.ssid`	`string` Venue Wi-Fi network name.
`data.capabilities.facilities.wifi.password`	`string` Venue Wi-Fi password.
`data.capabilities.facilities.wifi.bandwidthMbps`	`integer` Estimated Wi-Fi bandwidth in Mbps.
`data.capabilities.facilities.wifi.notes`	`string` Additional Wi-Fi notes.
`data.capabilities.facilities.hospitalityNotes`	`string` Additional hospitality notes.
`data.capabilities.logistics`	`object` Venue travel and local logistics details.
`data.capabilities.logistics.directions`	`string` Venue directions or arrival instructions.
`data.capabilities.logistics.nearestAirports`	`string[]` Nearby airports.
`data.capabilities.logistics.areaNotes`	`string` Additional local area notes.
`data.capabilities.crew`	`object` Venue crew and labor details.
`data.capabilities.crew.localUnion`	`string` Local union name or number.
`data.capabilities.crew.penalties`	`string` Penalty, meal-break, or overtime notes.
`data.capabilities.crew.notes`	`string` Additional crew notes.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Delete a venue

DELETE/v1/teams/{teamId}/venues/{venueId}

Accepts a command to delete a venue.

Required scopes: venue:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.venueId`required	`string:uuid` Venue identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`expectedVersion`	`integer` Optional aggregate version guard.
`reason`	`string` Optional reason for deleting the venue.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.