XISUITEDokumentation

calendar-integrations

9 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1

External calendar accounts this person has connected#

GET/calendar/accountsToken

Antworten

  • 200Accounts returned, never their tokens
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/calendar/accounts" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Disconnect an account; calendars keep their entries and stop syncing#

DELETE/calendar/accounts/{id}Token

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring

Account UUID

Antworten

  • 200Account disconnected
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/calendar/accounts/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

The calendars that account can offer#

GET/calendar/accounts/{id}/calendarsToken

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring

Account UUID

Antworten

  • 200External calendars returned
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/calendar/accounts/{id}/calendars" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Where to send the person to connect an outside calendar#

GET/calendar/accounts/connect/{provider}Token

Parameter

NameOrtTypBeschreibung
providerPflichtPfadstring

google, microsoft or calendly

return_toPflichtQuerystring–

Antworten

  • 200Sign-in address returned
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/calendar/accounts/connect/{provider}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Connect an Apple or other published calendar by its link#

POST/calendar/accounts/icsToken

Request-Bodyapplication/jsonConnectIcsDto

NameTypBeschreibung
urlPflichtstring

The published calendar link, https:// or webcal://

namestring

What to call it

Antworten

  • 201Link accepted and stored
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/calendar/accounts/ics" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"…"}'

Link a calendar to an external one#

PUT/calendar/calendars/{id}/syncToken

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring

Calendar UUID

Request-Bodyapplication/jsonLinkCalendarSyncDto

NameTypBeschreibung
account_idPflichtstring

A calendar account this person connected

external_calendar_idPflichtstring

Which calendar at the provider

directionstring

Import brings changes in only; two_way also sends ours out

Werte: importexporttwo_way

Standard: "two_way"

Antworten

  • 200Linked
  • 400That external calendar is already linked here
Beispiel (cURL)
curl -X PUT "https://xapi.ambertech.cloud/api/v1/calendar/calendars/{id}/sync" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"…","external_calendar_id":"…"}'

Stop syncing; imported entries stay#

DELETE/calendar/calendars/{id}/syncToken

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring

Calendar UUID

Antworten

  • 200Unlinked
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/calendar/calendars/{id}/sync" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Bring changes in now#

POST/calendar/calendars/{id}/sync/runToken

Parameter

NameOrtTypBeschreibung
idPflichtPfadstring

Calendar UUID

Antworten

  • 201Counts of what came in and what was removed
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/calendar/calendars/{id}/sync/run" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Entries brought in from connected calendars the caller may read#

GET/calendar/integrations/recordsToken

Parameter

NameOrtTypBeschreibung
pageQuerynumber–
limitQuerynumber–
providerQuerystring

Werte: googlemicrosoftcalendlyicszoom

statusQuerystring

Werte: syncedremovedunlinkedall

calendar_idQuerystring

Only entries of this calendar

qQuerystring

Matches the title or the calendar name

sortQuerystring

Column to sort by; newest change first when left out

Werte: sourceeventcalendarstartsendsstatuslast_synced

dirQuerystring

Werte: ascdesc

Antworten

  • 200One page of imported entries, newest change first
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/calendar/integrations/records" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions