Skip to main content
Working HoursVersion: v3

Update Agent Working Hours

PUT/conversation-ai/agents/{agentId}/working-hours

Fully replaces the working-hours configuration for an AI agent. Returns 404 when none exists yet — use the create endpoint first. This is a replace, not a merge: omitted fields are not preserved.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:conversation-ai.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

agentIdstringrequired

Conversations AI agent id

Example:EmployeeId123

Body

enabledbooleanrequired

Master toggle for working hours.

Example:false
channelsstring[]required

Channels the gate applies to. Must be non-empty when enabled.

Available optionsSMSEmailWhatsAppIGFBWebChatLive_ChatTIKTOK
Example:["SMS","WhatsApp"]
timezoneModestringrequired
Available optionscontactbusiness
scheduleobjectrequired
continueConversationsobjectrequired
offHoursAutoReplyobjectrequired
followUpobjectrequired

Response

Successful response

dataobjectrequired
successbooleanrequired
Example:true