Booking · Seat groups
Update seat group
Updates a seat group's name and maxAttendees using the organization and seat group IDs. The endpoint returns no response body.
Permissions
Send an API key of the organization in the path, using the X-API-Key header.
Who may call it
- Callers must have organization access and the
event.editpermission.
Request
Path parameters
-
organizationIdidrequired -
seatGroupIdidrequired
Body
Content-Type: application/json
-
namestringrequired1–60 characters
-
maxAttendeesintegerrequired
Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
--request POST 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/booking/seatGroups/YOUR_SEAT_GROUP_ID/update' \
--header 'X-API-Key: YOUR_API_KEY'const response = await fetch("https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/booking/seatGroups/YOUR_SEAT_GROUP_ID/update", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY"
},
redirect: 'error',
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) throw new Error(`campai HTTP ${response.status}`);
const text = await response.text();
const result = text ? JSON.parse(text) : null;
console.log(JSON.stringify(result, null, 2));<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => [
'X-API-Key: YOUR_API_KEY',
],
'timeout' => 30,
'follow_location' => 0,
'ignore_errors' => true,
]]);
$text = @file_get_contents('https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/booking/seatGroups/YOUR_SEAT_GROUP_ID/update', false, $context);
preg_match('/^HTTP\/\S+ (\d{3})/', $http_response_header[0] ?? '', $match);
$status = (int) ($match[1] ?? 0);
if ($text === false || $status < 200 || $status >= 300) {
throw new RuntimeException("campai HTTP $status (0 means no response)");
}
$result = $text === '' ? null : json_decode($text, true, 512, JSON_THROW_ON_ERROR);
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
No request that worked has been recorded yet, so the body is not shown.
Response
200 Successful response
No response body is specified.
What else happens
- Updates
nameandmaxAttendeeson the matchingeventSeatGroupsrecord. - For each uncanceled future event using the seat group that has waitlisted attendees, starts a
booking.offerManyAttendeeWaitlistSeatsjob onDefaultQueue.
Errors
Other errors
| Status | Error | When |
|---|---|---|
| 404 | The seat group was not found | If the seat group is not found in the organization, the endpoint returns HTTP 404 with key routes.booking.seatGroups.noSeatGroup. |
Errors nearly every request can meet are listed under Errors.