GET /api/v1/bookings/{bookingId}/details
Reads or edits the public information and private preparation notes for one sales call. Omitted fields remain unchanged; explicit null clears a field.
| Role in the organization | This endpoint |
|---|
OWNER | Allowed with current organization permissions |
ADMIN | Allowed with current organization permissions |
MEMBER | Conditional on the business role and scope below |
| Requirement | Rule for this endpoint |
|---|
| Business role | Assigned closer, or setter who booked the call |
| Resource scope | Organization bound to the API key |
| Participation | Call must be visible to the bearer |
| Resource state | No additional state restriction |
Private notes are returned only to owner/admin and the currently assigned closer. Setter responses omit the privateNotes property entirely.
| Parameter | Type | Required | Description |
|---|
bookingId | UUID | yes | Booking identifier |
| Header | Required | Description |
|---|
x-api-key | yes | Organization API key |
X-Correlation-Id | no | Correlation UUID for support |
curl -X GET "$COHORTE_API_BASE_URL/api/v1/bookings/11111111-1111-4111-8111-111111111111/details" \
-H "x-api-key: $COHORTE_API_KEY"
200: successful read, save or replay.400: invalid identifier, payload or missing idempotency key.401: invalid key or membership.403: insufficient permissions.404: booking absent or outside this organization.429: rate limit reached.500: unexpected failure.
| Field | Type | Nullable | Description |
|---|
success | boolean | no | Successful request |
data.bookingId | UUID | no | Booking identifier |
data.meetingUrl | string | yes | Effective link stored on this call |
data.publicInstructions | string | yes | Public information |
data.privateNotes | string | yes | Private note; property omitted for setters |
data.canEdit | boolean | no | Current editing permission |
data.hasProspectEmail | boolean | no | Whether a prospect email is available |
{
"success": true,
"data": {
"bookingId": "11111111-1111-4111-8111-111111111111",
"meetingUrl": null,
"publicInstructions": null,
"privateNotes": null,
"canEdit": true,
"hasProspectEmail": true
}
}
This read changes nothing.
Meeting-link updates appear on the personal public page and newly generated calendar exports. Already imported external events are not synchronized. Notes never appear on the prospect page, emails or calendars. No management link is recovered or replaced.
