Update a venue

A patch: omitted fields are left alone. Changing address clears distanceMeters and durationSeconds and schedules a fresh lookup, so both read null until it lands.

Errors

404 venue_not_found — unknown ID, or one belonging to another tenant.
422 venue_name_required — name present but blank.

PATCH/api/v1/venues/{id}

Authorization

AuthorizationBearer token (bloomcount_...) · headerrequired

Path parameters

idstringrequired

Request body

requiredapplication/json

namestring

What the venue is called. Required to create.

addressstring

Full postal address. Setting or changing it schedules the distance lookup; distanceMeters and durationSeconds read null until that finishes.

googleMapsUrlstring

A maps link for whoever is driving. Not used for routing.

phonestring

The venue's main number.

websitestring

The venue's website.

contactNamestring

Who to speak to at the venue.

contactEmailstring

Email for that contact.

contactPhonestring

Direct number for that contact.

notesstring

Free text — access

entryStartstring

Earliest access time

entryEndstring

Latest access time

Responses

200Updated

venueIdstringrequired

namestringrequired

What the venue is called. This is what an event shows.

addressstring | null

Full postal address. What the driving distance is measured to, so a venue without one has no distance.

googleMapsUrlstring | null

A maps link for whoever is driving. Not used for routing.

phonestring | null

The venue's main number.

websitestring | null

The venue's website.

contactNamestring | null

Who to speak to at the venue.

contactEmailstring | null

Email for that contact.

contactPhonestring | null

Direct number for that contact

notesstring | null

Free text — access

entryStartstring | null

Earliest time the venue allows access, as free text.

entryEndstring | null

Latest time the venue allows access, as free text.

distanceMetersinteger | null

Driving distance from your business address. Null until the background lookup has run, or when either address is missing.

durationSecondsinteger | null

Driving time from your business address, on the same terms as distanceMeters.

401Missing or invalid API key, or revoked / expired.

errorstringrequired

403Authenticated, but the key lacks the required scope or the tenant has no API access.

errorstringrequired

404The requested resource doesn't exist or belongs to a different tenant.

errorstringrequired

422Request body or arguments failed validation.

errorstringrequired

429Per-minute rate limit (60/min) or per-month cap exceeded.

errorstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (bloomcount_...)Remember on this deviceInclude my values in samples

Parameters

idpath*

Bodyapplication/json

namestringWhat the venue is called. Required to create.addressstringFull postal address. Setting or changing it schedules the distance lookup; distanceMeters and durationSeconds read null until that finishes.googleMapsUrlstringA maps link for whoever is driving. Not used for routing.phonestringThe venue's main number.websitestringThe venue's website.contactNamestringWho to speak to at the venue.contactEmailstringEmail for that contact.contactPhonestringDirect number for that contact.notesstringFree text — accessentryStartstringEarliest access timeentryEndstringLatest access time

Request

curl -X PATCH "https://app.bloomcount.com/api/v1/venues/ven_k2m7p4r9t3v6x1z8b5n0q7w4" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "address": "string",
  "googleMapsUrl": "string",
  "phone": "string",
  "website": "string",
  "contactName": "string",
  "contactEmail": "string",
  "contactPhone": "string",
  "notes": "string",
  "entryStart": "string",
  "entryEnd": "string"
}'

const response = await fetch("https://app.bloomcount.com/api/v1/venues/ven_k2m7p4r9t3v6x1z8b5n0q7w4", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"address\": \"string\",\n  \"googleMapsUrl\": \"string\",\n  \"phone\": \"string\",\n  \"website\": \"string\",\n  \"contactName\": \"string\",\n  \"contactEmail\": \"string\",\n  \"contactPhone\": \"string\",\n  \"notes\": \"string\",\n  \"entryStart\": \"string\",\n  \"entryEnd\": \"string\"\n}"
});

import requests

response = requests.patch(
    "https://app.bloomcount.com/api/v1/venues/ven_k2m7p4r9t3v6x1z8b5n0q7w4",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"address\": \"string\",\n  \"googleMapsUrl\": \"string\",\n  \"phone\": \"string\",\n  \"website\": \"string\",\n  \"contactName\": \"string\",\n  \"contactEmail\": \"string\",\n  \"contactPhone\": \"string\",\n  \"notes\": \"string\",\n  \"entryStart\": \"string\",\n  \"entryEnd\": \"string\"\n}",
)

Response

{
  "venueId": "ven_k2m7p4r9t3v6x1z8b5n0q7w4",
  "name": "The Manor Barn",
  "address": "The Manor Barn, Bath BA1 5TQ",
  "googleMapsUrl": null,
  "phone": "+44 1225 000000",
  "website": null,
  "contactName": "Rosa Levine",
  "contactEmail": "events@manorbarn.example",
  "contactPhone": null,
  "notes": "Deliveries to the courtyard entrance.",
  "entryStart": null,
  "entryEnd": null,
  "distanceMeters": 18400,
  "durationSeconds": 1620
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}