Update Cal.com

Endpoint to update a Cal.com integration in the ToolzzAI agent.

Request Example

curl --request PUT \
  --url https://chat.api.toolzz.com.br/api/v1/calcom/integration/{integrationId} \
  --header 'Authorization: Bearer TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --data '
  {
    "title": "<string>",
    "unitId": "uuid",
    "calcomUsername": "<string>",
    "timezone": "<string_timezone>",
    "prompt": "<string_prompt_ia>",
    "checkAvailabilityEnabled": boolean,
    "createBookingEnabled": boolean
  }
'

Response Example

{
  "id": "uuid",
  "title": "string",
  "calcomUsername": "string",
  "timezone": "string",
  "prompt": "string",
  "apiKey": "cal_string",
  "isTokenMasked": true,
  "isActive": true,
  "checkAvailabilityEnabled": boolean,
  "createBookingEnabled": boolean,
  "botId": null,
  "unitId": "uuid",
  "defaultEventTypeId": null,
  "defaultEventTypeSlug": null,
  "createdAt": "YYYY-MM-DD HH:mm:ss.SSSSSS",
  "updatedAt": "YYYY-MM-DD HH:mm:ss.SSS"
}

Request description

Access Token

Parameter	Type	Description	Required
Authorization	String	Access token (“Bearer” must be before the token)	Yes

URL Parameters (Path)

Parameter	Type	Description	Required
integrationId	UUID	Unique configuration identifier in the database.	Yes

Body Parameters

Key	Type	Description	Required
title	String	Tool identifier name in the panel (e.g., “Calcom”).	Yes
unitId	UUID	Unique identifier of the owning organizational unit.	Yes
calcomUsername	String	Username or profile slug on the Cal.com platform.	Yes
timezone	String	Default timezone for appointments (e.g., UTC).	Yes
prompt	String	Function Instruction: Commands that guide the AI’s behavior.	Yes
checkAvailabilityEnabled	Boolean	If true, allows the AI to check calendar availability.	Yes
createBookingEnabled	Boolean	If true, allows the AI to make new appointments.	Yes

---

Response description

Key	Type	Description
id	UUID	Unique configuration identifier in the database.
title	String	Tool identifier name (e.g., “Calcom”).
calcomUsername	String	Username or profile slug on Cal.com.
timezone	String	Default timezone configured for the calendar.
prompt	String	Function Instruction: Prompt that guides the AI’s behavior.
apiKey	String	API key masked for security.
isTokenMasked	Boolean	Indicates that the apiKey is hidden by asterisks.
isActive	Boolean	Defines if the integration is enabled for operation.
checkAvailabilityEnabled	Boolean	Permission for the AI to read available times.
createBookingEnabled	Boolean	Permission for the AI to make new appointments.
botId	Null/UUID	Toolzz AI Agent ID: Linked AI identifier.
unitId	UUID	Unique identifier of the owning organizational unit.
defaultEventTypeId	Null/Number	Default event type ID (e.g., fixed meeting).
defaultEventTypeSlug	Null/Str	Default event type slug (e.g., 30min).
createdAt	String	Original record creation date and time.
updatedAt	String	Date and time of the last data update.

---

Security

To access this endpoint, it is necessary to send a valid access token through the authorization header (Authorization) of the request. Additionally, the API is protected by other security measures to safeguard user data.

To access your access token, follow these steps:

1. Log in to the ToolzzAI platform
2. Click on “Settings”
3. Click on “Access Token”
4. Copy the access token