Update a booth

Hold, reserve, sell, block or release a booth, assign it to an exhibitor or sponsor, set its own price, or move it to another booth package. Send only the fields to change.

• available releases the booth: its account and hold are cleared, unless you send an account_id in the same request.
• reserved and sold need an account — the one already on the booth, or account_id.
• hold with hold_until keeps the booth for the account until then; after that the booth reads available.
• account_id: null removes the account.

account_id must be an exhibitor or sponsor of this event. product_id must be a booth package of this event (a ticket type of type booth); the booth moves into that package and out of any other. product_id: null takes it out of every package.

Recorded in the event’s History as an API change. Requires write:expo.

PUT /v1/event/{eventId}/booths/{boothId}

cURL

hold

curl --request PUT \
  --url https://public-api.sessionboard.com/v1/event/{eventId}/booths/{boothId} \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "status": "hold",
  "account_id": "e1d2c3b4-a5f6-4789-8a9b-0c1d2e3f4a5b",
  "hold_until": "2026-11-03T23:59:00Z"
}
'

200

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "floor_map_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "hall_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "number": "<string>",
    "status": "available",
    "stored_status": "available",
    "booth_type": "<string>",
    "list_price_cents": 123,
    "price_cents": 123,
    "currency": "<string>",
    "hold_until": "2023-11-07T05:31:56Z",
    "geom": {},
    "fill_color": "<string>",
    "product": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "price_cents": 123
    },
    "account": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "application_id": "<string>",
    "order_id": "<string>"
  }
}

Authorizations

ApiKeyBearerToken

x-access-token · string · header · required

Organization API token. Generate from Organization Settings → API Tokens.

Path Parameters

eventId · integer · required

Event ID

boothId · string<uuid> · required

The booth ID.

Body

application/json

status · enum<string>

Available options: available, hold, reserved, sold, blocked

account_id · string<uuid> | null

An exhibitor or sponsor of this event; null removes the account.

hold_until · string<date-time> | null

Until when a hold lasts; null clears it.

list_price_cents · integer | null

The booth's own price in cents; null falls back to its package price.

Required range: x >= 0

product_id · string<uuid> | null

The booth package (a ticket type of type booth) to sell this booth in; null removes it from every package.

Response

200

application/json

The booth after the change, in the same shape as the list.

data · object

Show child attributes