Skip to main content

autessa.googleCalendar

10 methods in the googleCalendar namespace.

autessa.googleCalendar.connectors.allREAD

autessa.googleCalendar.connectors.all()

List every Google Calendar connector you can access in your company.

Returns all Google Calendar connectors in your current company that you have at least READ access to, newest-relevant first. Use a connector's connectorId with the other googleCalendar.connectors.* methods. Credentials are never included in the returned DTOs.

Request fields

No fields.

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    connectors
    Type
    GoogleCalendarConnectorDto[]
    Description

autessa.googleCalendar.connectors.deleteMUTATE

autessa.googleCalendar.connectors.delete({ connectorId })

Permanently delete a Google Calendar connector and its stored credential.

Removes the Google Calendar connector for connectorId, revoking every tool and script that relied on it. The stored credential is destroyed and cannot be recovered — reconnecting requires the full auth flow again. Requires WRITE (owner-level) access.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    message
    Type
    string
    Description

autessa.googleCalendar.connectors.getREAD

autessa.googleCalendar.connectors.get({ connectorId })

Fetch one Google Calendar connector by id.

Returns the full Google Calendar connector for connectorId, including its sharing/active state and the linked account metadata — but never the stored credential. Fails if you lack READ access to the connector.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    connector
    Type
    GoogleCalendarConnectorDto
    Description

autessa.googleCalendar.connectors.getSharingDetailsREAD

autessa.googleCalendar.connectors.getSharingDetails({ connectorId })

Read the current sharing configuration of a Google Calendar connector.

Returns how the Google Calendar connector is shared: the overall sharingLevel, the companyPermissionLevel granted for COMPANY sharing, the explicit sharedWith members, and your own userAccessLevel. Use before share to see the current state.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    sharingLevel
    Type
    "PRIVATE" | "SPECIFIC_MEMBER" | "COMPANY"
    Description
  • Name
    companyPermissionLevel
    Type
    "READ" | "WRITE" | "PUBLISH" | "ADMIN"
    Description
  • Name
    sharedWith
    Type
    UserShareWrapper[]
    Description
  • Name
    userAccessLevel
    Type
    "READ" | "WRITE" | "PUBLISH" | "ADMIN"
    Description

autessa.googleCalendar.connectors.shareMUTATE

autessa.googleCalendar.connectors.share({ connectorId, level, accessLevel, usersToAdd, usersToRemove })

Change who in your company can use a Google Calendar connector.

Sets the sharing scope of the Google Calendar connector. level=PRIVATE keeps it to the owner; level=COMPANY grants everyone in the company the given accessLevel; level=SPECIFIC_MEMBER shares with named users — add them in usersToAdd and revoke via usersToRemove (each as a UserShareWrapper). accessLevel applies to COMPANY sharing. Sharing lets other members' tools and scripts use the connector; the credential itself is never exposed. Requires WRITE access.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.
  • Name
    level
    Type
    "PRIVATE" | "SPECIFIC_MEMBER" | "COMPANY"
    Description
  • Name
    accessLevel
    Type
    "READ" | "WRITE" | "PUBLISH" | "ADMIN"
    Description
  • Name
    usersToAdd
    Type
    UserShareWrapper[]
    Description
  • Name
    usersToRemove
    Type
    UserShareWrapper[]
    Description

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    level
    Type
    "PRIVATE" | "SPECIFIC_MEMBER" | "COMPANY"
    Description
  • Name
    accessLevel
    Type
    "READ" | "WRITE" | "PUBLISH" | "ADMIN"
    Description
  • Name
    usersWithAccess
    Type
    UserShareWrapper[]
    Description

autessa.googleCalendar.connectors.syncCalendarsMUTATE

autessa.googleCalendar.connectors.syncCalendars({ connectorId })

Re-sync a Google Calendar connector's calendar list from the Google Calendar API.

Fetches the current calendars from the Google Calendar API and updates the connector's stored metadata, picking up calendars added or removed on the Google side since the last sync. Use this before viewAvailableCalendars or updateAvailableCalendars when the linked account's calendars may have changed. Requires WRITE access.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    message
    Type
    string
    Description
  • Name
    syncPerformed
    Type
    boolean
    Description

autessa.googleCalendar.connectors.updateMUTATE

autessa.googleCalendar.connectors.update({ connectorId, connectorName, isActive })

Rename a Google Calendar connector or toggle whether it is active.

Applies a sparse patch to the Google Calendar connector for connectorId: send connectorName to rename it, isActive to enable/disable it. This is a partial update — omit a field to leave it unchanged; sending null or an empty name is ignored. Does not touch the stored credential or sharing. Requires WRITE access.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.
  • Name
    connectorName
    Type
    string
    Description
  • Name
    isActive
    Type
    boolean
    Description

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    message
    Type
    string
    Description
  • Name
    connector
    Type
    GoogleCalendarConnectorDto
    Description

autessa.googleCalendar.connectors.updateAvailableCalendarsMUTATE

autessa.googleCalendar.connectors.updateAvailableCalendars({ connectorId, calendarsToEnable, calendarsToDisable })

Enable or disable which calendars a Google Calendar connector's tools may use.

Toggles which of the connector's known calendars are enabled for use by tools: list calendar ids in calendarsToEnable to turn them on and in calendarsToDisable to turn them off. Only calendars already present in the stored metadata are affected — unknown ids are silently ignored. Run syncCalendars first so the metadata contains the calendar you want to enable. Requires WRITE access.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.
  • Name
    calendarsToEnable
    Type
    string[]
    Description
  • Name
    calendarsToDisable
    Type
    string[]
    Description

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    message
    Type
    string
    Description
  • Name
    enabledCalendars
    Type
    CalendarDto[]
    Description

autessa.googleCalendar.connectors.viewAvailableCalendarsREAD

autessa.googleCalendar.connectors.viewAvailableCalendars({ connectorId })

List the calendars visible to a Google Calendar connector's linked account.

Returns every calendar the connector's linked Google account can see, each with its enabled/disabled state from the stored config. Viewing does not refresh the stored calendar metadata; run syncCalendars to pick up calendars added or removed on the Google side. Requires READ access.

Request fields

  • Name
    connectorId
    Type
    string (opaque id)
    Description
    References external connector by opaque id.

Response fields

  • Name
    errors
    Type
    string[]
    Description
  • Name
    deprecationWarnings
    Type
    string[]
    Description
  • Name
    sessionToken
    Type
    string
    Description
  • Name
    calendars
    Type
    CalendarDto[]
    Description