DevelopersHow to connect an assistantKeys
Reference/Profile/Change

Disconnect Google Calendar

POSThttps://api.getwerk.ai/api/v1/account/google-calendar/disconnect

Ends the key's person's Google Calendar connection.

Werk lets go of its access; the Werk calendar and its events stay in their Google account.

Authorization

AuthorizationheaderRequired

Authorization: Bearer <key> Authentication

Body

clientRequestIdstring, uuidRequired

An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused.

Response

200 The connection after the change.

stateenum

not_connected, connecting while it is being set up, connected, no_access once Werk lost access, or disconnected.

Allowed valuesnot_connectedconnectingconnectedno_accessdisconnected
accountstring, email or null

The Google account connected, or null.

matchedAtstring, date-time or null

When the Werk calendar last held the whole agenda, or null.

reasonenum or null

Why the connection stopped: access withdrawn, the calendar removed, or an error of Werk's; null otherwise.

Allowed valuesaccess_withdrawncalendar_removedwerk_error

Errors

400invalid_queryThe query is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).
400invalid_account_requestThe account request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).
401session_revokedThe request carries no session the server holds, or its session has ended.
401session_expiredThe session has expired.
409session_changedThe session changed while the request was in flight.
409request_conflictThe request id was already used with another request, or the change it asks could not be made to the record it names.
409request_erasedThe request id belongs to a request whose record was erased.
413payload_too_largeThe request body has more bytes than the route takes.
rate_limitedMore requests of this kind were sent than Werk takes within the time it counts them over.
500server_errorThe server could not complete the request, and it is not known whether a write it holds was made.
curl
curl -X POST "https://api.getwerk.ai/api/v1/account/google-calendar/disconnect" \
  -H "Authorization: Bearer wk_key_..." \
  -H "Content-Type: application/json" \
  -d '{
    "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c09"
  }'
TypeScript
const res = await fetch("https://api.getwerk.ai/api/v1/account/google-calendar/disconnect", {
  method: "POST",
  headers: {
    Authorization: "Bearer wk_key_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c09"
  }),
});
const answer = await res.json();
200JSON
{
  "state": "disconnected",
  "account": null,
  "matchedAt": null,
  "reason": null
}