Events

Create an event space slot

Books a space of the event's venue for a day, optionally between two times. The space joins the event's spaces; a space with slots is only busy during them (conflict checks, availability). The event must have a venue. Pushes the change to the connected calendars. Role permission: data.write.

post/events/{id}/slots

Request

  • Base URL: https://joinways.app/api/v1
  • URL: https://joinways.app/api/v1/events/{id}/slots
  • 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

space_idstring uuid required

A space of the event's venue.

day_datestring date required
start_timestring nullable

HH:MM. Give both times or neither (whole day).

end_timestring nullable

HH:MM, different from start_time; before it = next day.

labelstring nullable
quote_item_idstring uuid nullable

A line of a quote of this event.

sort_orderinteger

Example request

{
  "day_date": "2026-10-16",
  "start_time": "09:00",
  "end_time": "12:30",
  "label": "Plénière"
}

Response

The created slot.

idstring uuid
space_idstring uuid
space_namestring
day_datestring date
start_timestring nullable
end_timestring nullable
labelstring nullable
quote_item_idstring uuid nullable

Quote line the slot was booked from, if any.

Example response

{
  "space_name": "Plénière",
  "day_date": "2026-10-16",
  "start_time": "09:00",
  "end_time": "12:30",
  "label": "Séminaire"
}

Changes

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