Venues

Block dates (add a closure)

Blocks the venue (or space) for a date range, whole days or between two times. Public holidays go through POST /venues/{venueId}/holidays. Role permission: settings.manage.

post/venues/{venueId}/closures

Request

  • Base URL: https://joinways.app/api/v1
  • URL: https://joinways.app/api/v1/venues/{venueId}/closures
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://joinways.app/oauth/authorize, token URL https://joinways.app/api/oauth/token, scopes: mcp.write)

Headers

Idempotency-Keystring

Optional client-generated key (1 to 255 characters, e.g. a UUID v4) that makes the request idempotent for 24 hours: a retry with the same key replays the recorded response (marked Idempotency-Replayed: true) instead of executing the operation again. Same key with another body: 422 idempotency_key_reuse; while the first request runs: 409 idempotency_conflict. See the Idempotency section.

Request body

startDatestring date required
endDatestring date required

On or after startDate.

startTimestring nullable

HH:MM. Give both times or neither (whole days); endTime after startTime.

endTimestring nullable
reasonstring nullable
colorstring nullable
closureType'manual'

Only manual; public holidays go through POST /venues/{venueId}/holidays.

Response

The created closure.

Changes

No recorded changes to this operation across all 1 revision of this API.