Skip to content

Update Events

Endpoint

http
PATCH /unified/calendar/events/{id}
Integrations supported
  • Google Calendar
  • Outlook Calendar

Path parameters

id
string
REQUIRED · The ID of the resource.
Example: 23423523

Query parameters

Refer Specifying query parameters in Truto APIs

integrated_account_id
string · uuid
REQUIRED · The ID of the integrated account to use for the request.
Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_format
string
The format of the response. Defaults to `unified`. `unified` will return the response with unified mappings applied. `raw` will return the raw response from the remote API. `normalized` will apply the unified mappings and return the data in a normalized format.
All possible enum values:
  • unified
  • raw
  • normalized
Example: unified
truto_ignore_remote_data
boolean
Excludes the `remote_data` attribute from the response.
truto_exclude_fields
array
Array of fields to exclude from the response.
Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_query
object
Query parameters to pass to the underlying API without any transformations.
Example: remote_query[foo]=bar
send_notifications
string
All possible enum values:
  • all
  • external_only
  • none
Supported in
  • Google Calendar

Request Body

Refer Writing data using Unified APIs

calendar
object
The calendar associated with the event.
Required in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the calendar.
name
string
The name of the calendar.
start_time
string · date-time
REQUIRED · If providing the start_time, the end_time should also be provided.
Required in
  • Google Calendar
Supported in
  • Outlook Calendar
end_time
string · date-time
If providing the end_time, the start_time should also be provided.
Required in
  • Google Calendar
Supported in
  • Outlook Calendar
timezone
string
Required if start_time or end_time is provided.
Supported in
  • Google Calendar
  • Outlook Calendar
title
string
REQUIRED · The title of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
description
string
The description of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
status
string
The status of the event.
All possible enum values:
  • confirmed
  • tentative
  • cancelled
  • draft
Supported in
  • Google Calendar
availability
string
The availability of the user during the time period of the event.
All possible enum values:
  • busy
  • free
Supported in
  • Google Calendar
visibility
string
The visibility of the event.
All possible enum values:
  • calendar_default
  • public
  • private
Supported in
  • Google Calendar
recurrence
string[]
The recurrence of the event. List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545.
Supported in
  • Google Calendar
attendees
object[]
The attendees associated with the event.
Supported in
  • Google Calendar
  • Outlook Calendar
person
object
The person associated with the attendee.
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
is_optional
boolean
Indicates if the attendance is optional.
is_self
boolean
Indicates if the attendee is the authenticated user.
is_organizer
boolean
Indicates if the attendee is the organizer of the event.
response
object
The response of the attendee.
status
string
The status of the response.
All possible enum values:
  • needs_action
  • declined
  • tentative
  • accepted
comment
string
The comment of the response.
guests_can_invite_others
boolean
Indicates if guests can invite others to the event.
Supported in
  • Google Calendar
guests_can_modify
boolean
Indicates if guests can modify the event.
Supported in
  • Google Calendar
guests_can_see_other_guests
boolean
Indicates if guests can see other guests of the event.
Supported in
  • Google Calendar
location
object
The location of the event.
Supported in
  • Outlook Calendar
id
string
The unique identifier of the location.
name
string
The name of the location.
address
object
street_1
string
The first line of the street address.
street_2
string
The second line of the street address.
city
string
The city of the address.
state
string
The state of the address.
country
string
The country of the address.
postal_code
string
The postal code of the address.
url
string
The URL of the location.
coordinates
object
latitude
number
The latitude of the location.
longitude
number
The longitude of the location.
remote_data
object
Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.

Response Body

id
string
REQUIRED · The unique identifier of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
calendar
object
The calendar associated with the event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the calendar.
name
string
The name of the calendar.
title
string
REQUIRED · The title of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
description
string
The description of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
location
object
The location of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the location.
name
string
The name of the location.
address
object
street_1
string
The first line of the street address.
street_2
string
The second line of the street address.
city
string
The city of the address.
state
string
The state of the address.
country
string
The country of the address.
postal_code
string
The postal code of the address.
url
string
The URL of the location.
coordinates
object
latitude
number
The latitude of the location.
longitude
number
The longitude of the location.
timezone
string
The timezone of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
start_time
string · date-time
REQUIRED · The date and time when the event starts.
Supported in
  • Google Calendar
  • Outlook Calendar
end_time
string · date-time
The date and time when the event ends.
Supported in
  • Google Calendar
  • Outlook Calendar
status
string
The status of the event.
All possible enum values:
  • confirmed
  • tentative
  • cancelled
  • draft
Supported in
  • Google Calendar
  • Outlook Calendar
attendees
object[]
The attendees associated with the event.
Supported in
  • Google Calendar
  • Outlook Calendar
person
object
The person associated with the attendee.
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
is_optional
boolean
Indicates if the attendance is optional.
is_self
boolean
Indicates if the attendee is the authenticated user.
is_organizer
boolean
Indicates if the attendee is the organizer of the event.
response
object
The response of the attendee.
status
string
The status of the response.
All possible enum values:
  • needs_action
  • declined
  • tentative
  • accepted
comment
string
The comment of the response.
created_by
object
The person who created the event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
organized_by
object
The person who created the event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
type
string
The type of the event.
All possible enum values:
  • default
  • out_of_office
  • focus_time
  • working_location
Supported in
  • Google Calendar
  • Outlook Calendar
availability
string
The availability of the user during the time period of the event.
All possible enum values:
  • busy
  • free
Supported in
  • Google Calendar
  • Outlook Calendar
visibility
string
The visibility of the event.
All possible enum values:
  • calendar_default
  • public
  • private
Supported in
  • Google Calendar
  • Outlook Calendar
identifiers
object
The identifiers associated with the event.
Supported in
  • Google Calendar
  • Outlook Calendar
ical_uid
string
The iCalendar UID of the event.
ical_sequence
string
The iCalendar sequence of the event.
is_locked
boolean
Indicates if the event is locked and cannot be modified.
Supported in
  • Google Calendar
urls
object
The URLs associated with the event.
Supported in
  • Google Calendar
  • Outlook Calendar
url
string
The URL of the event.
type
string
The type of the URL.
is_recurring
boolean
Indicates if the event is recurring.
Supported in
  • Google Calendar
  • Outlook Calendar
recurrence
string[]
The recurrence of the event. List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545.
Supported in
  • Google Calendar
  • Outlook Calendar
parent_event
object
The parent event of a recurring event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the parent event.
has_attachments
boolean
Indicates if the event has attachments.
Supported in
  • Google Calendar
  • Outlook Calendar
attachments
object[]
The attachments associated with the event.
Supported in
  • Google Calendar
id
string
The unique identifier of the attachment.
name
string
The name of the attachment.
mime_type
string
The MIME type of the attachment.
url
string
The URL of the attachment.
created_at
string · date-time
The date when the attachment was created.
updated_at
string · date-time
The date when the attachment was updated.
guests_can_invite_others
boolean
Indicates if guests can invite others to the event.
Supported in
  • Google Calendar
guests_can_modify
boolean
Indicates if guests can modify the event.
Supported in
  • Google Calendar
guests_can_see_other_guests
boolean
Indicates if guests can see other guests of the event.
Supported in
  • Google Calendar
event_type
object
The event type object associated with the event.
id
string
The unique identifier of the event type.
created_at
string · date-time
The date when the event was created.
Supported in
  • Google Calendar
  • Outlook Calendar
updated_at
string · date-time
The date when the event was updated.
Supported in
  • Google Calendar
  • Outlook Calendar
remote_data
object
Raw data returned from the remote API call.