Update Calendar Event

Update an existing calendar event

PUT /api/v1/calendar/events/{event_id}/update

Update Calendar Event

cURL

curl --request PUT \
  --url https://api.example.com/api/v1/calendar/events/{event_id}/update \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "event_type": "<string>",
  "status": "<string>",
  "location": "<string>",
  "customer_name": "<string>",
  "customer_email": "<string>",
  "customer_phone": "<string>",
  "customer_notes": "<string>",
  "has_video_conference": true,
  "video_conference_url": "<string>",
  "video_conference_provider": "<string>",
  "is_reminder_enabled": true,
  "remind_before_minutes": 123,
  "ai_agent_id": 123,
  "team_id": 123,
  "sync_external_calendars": true,
  "send_notifications": true
}
'

200

{
  "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": "[e-mail]",
    "customer_phone": "[phone]",
    "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"
}