Skip to main content
PUT
/
api
/
v1
/
calendar
/
events
/
{event_id}
/
update
{
  "id": 123,
  "uuid": "<string>",
  "title": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "status": "<string>",
  "message": "<string>",
  "error": "<string>"
}
Update an existing calendar event. You can use either PUT (full update) or PATCH (partial update) methods.

​
Path Parameters

​
event_id
string
required
ID or UUID of the event to update.

​
Request Body

​
title
string
Event title.
​
description
string
Event description.
​
start_time
string
Event start time.
​
end_time
string
Event end time.
​
event_type
string
Type of event. One of: meeting, appointment, busy, voice_call, video_call.
​
status
string
Event status. One of: scheduled, confirmed, cancelled, completed, no_show.
​
location
string
Event location.
​
customer_name
string
Customer name.
​
customer_email
string
Customer email.
​
customer_phone
string
Customer phone number.
​
customer_notes
string
Notes about the customer or appointment.
​
has_video_conference
boolean
Whether the event has video conferencing enabled.
​
video_conference_url
string
URL for video conferencing.
​
video_conference_provider
string
Provider of video conferencing (e.g., Zoom, Google Meet, etc.).
​
is_reminder_enabled
boolean
Whether reminders are enabled for this event.
​
remind_before_minutes
integer
How many minutes before the event to send a reminder.
​
ai_agent_id
integer
ID of the AI agent to associate with this event.
​
team_id
integer
ID of the team to associate with this event.
​
sync_external_calendars
boolean
default:true
Whether to sync this update with connected external calendars.
​
send_notifications
boolean
default:true
Whether to send notifications about this update.

​
Response

​
id
integer
Event ID.
​
uuid
string
Event UUID.
​
title
string
Event title.
​
start_time
string
Event start time.
​
end_time
string
Event end time.
​
status
string
Event status.
​
message
string
Success message.

​
PUT vs PATCH

  • Use PUT when you want to replace the entire event with the new data (full update)
  • Use PATCH when you want to update only specific fields (partial update)

​
Example Request (PUT - Full Update)

curl -X PUT 'https://api.klen.ai/api/v1/calendar/events/456/update' \
  -H 'Authorization: Bearer klen_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Updated Product Demo",
    "description": "Updated product demonstration for client",
    "start_time": "2025-05-16T15:00:00.000Z",
    "end_time": "2025-05-16T16:00:00.000Z",
    "event_type": "video_call",
    "status": "confirmed",
    "location": "Online",
    "customer_name": "Jane Doe",
    "customer_email": "[email protected]",
    "customer_phone": "+15551234567",
    "has_video_conference": true,
    "video_conference_provider": "Zoom",
    "is_reminder_enabled": true,
    "remind_before_minutes": 30,
    "send_notifications": true
  }'

​
Example Request (PATCH - Partial Update)

curl -X PATCH 'https://api.klen.ai/api/v1/calendar/events/456/update' \
  -H 'Authorization: Bearer klen_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "start_time": "2025-05-16T15:00:00.000Z",
    "end_time": "2025-05-16T16:00:00.000Z",
    "send_notifications": true
  }'

​
Example Response

{
  "id": 456,
  "uuid": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
  "title": "Updated Product Demo",
  "start_time": "2025-05-16T15:00:00.000Z",
  "end_time": "2025-05-16T16:00:00.000Z",
  "status": "confirmed",
  "message": "Event updated successfully"
}

​
Error Responses

​
error
string
Error code.
​
message
string
Error message.

​
Not Found (404)

{
  "error": "not_found",
  "message": "Event not found or you do not have access"
}

​
Invalid Date Format (400)

{
  "error": "invalid_datetime_format",
  "message": "Invalid datetime format. Expected ISO 8601 format (YYYY-MM-DDTHH:MM:SS)"
}

​
Invalid Time Range (400)

{
  "error": "invalid_time_range",
  "message": "End time must be after start time"
}

​
Agent Not Found (404)

{
  "error": "agent_not_found",
  "message": "AI agent not found or you do not have access"
}

​
Team Not Found (404)

{
  "error": "team_not_found",
  "message": "Team not found or you do not have access"
}

​
Unauthorized (401)

{
  "error": "authentication_required",
  "message": "API key is required"
}

​
Permission Denied (403)

{
  "error": "permission_denied",
  "message": "This API key does not have can_write_calendar permission"
}

​
Server Error (500)

{
  "error": "server_error",
  "message": "An unexpected server error occurred"
}