Update booking status by ID (Admin)

Update the status of an existing booking by its ID. Requires admin authentication.

PATCH

https://api.channelautomation.com/api/calendar/bookings/{id}

Authorization

BearerAuth
optional
HTTP Bearer (JWT)

ApiKeyAuth
optional
API key in header

Path parameters

id
string
required
Booking ID

Request body JSON required

status
scheduled
or
completed
or
cancelled
required
New status for the booking

Returns

200

Booking status updated successfully

JSON

success
optional
boolean
booking
optional
object
- id
  optional
  string
  Unique appointment identifier
- contact_id
  optional
  string
  Associated contact ID
- workspace_id
  optional
  string
  Workspace ID
- created_by
  optional
  string
  ID of user who created the appointment
- title
  optional
  string
  Appointment title
- description
  optional
  string
  Appointment description
- appointment_date
  optional
  string
  Date and time of the appointment
  
  format: date-time
- duration_minutes
  optional
  integer
  Duration of the appointment in minutes
- location
  optional
  string
  Location of the appointment
- created_at
  optional
  string
  When the appointment was created
  
  format: date-time
- updated_at
  optional
  string
  When the appointment was last updated
  
  format: date-time
}

400

Missing or invalid status

JSON

success
optional
boolean
error
optional
string

401

Authentication required

JSON

error
optional
string
success
optional
boolean

403

Admin privileges required

JSON

error
optional
string
success
optional
boolean

404

Booking not found

JSON

success
optional
boolean
error
optional
string

500

Internal server error

JSON

error
optional
string
details
optional
string
success
optional
boolean

curl --request PATCH \ --url https://api.channelautomation.com/api/calendar/bookings/372e579b-7f9a-47ed-b161-24e69670035b \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "status": "completed" } '

{ "success": true, "booking": { "id": "appointment-uuid", "contact_id": "contact-uuid", "workspace_id": "workspace-uuid", "created_by": "464cf603-5a10-4470-a100-331fc0766680", "title": "Kitchen Renovation - John Smith", "description": "Kitchen Renovation booking for John Smith (john@example.com)", "appointment_date": "2025-07-15T09:00:00Z", "duration_minutes": 60, "location": "Customer's home", "created_at": "2025-07-08T10:00:00Z", "updated_at": "2025-07-08T10:00:00Z" } }