Skip to main content
PATCH
Update an AI Agent

Authorizations

X-API-Key
string
header
required

Supply the API Key in the HTTP-Header

Headers

Accept
enum<string>

The Accept header specifies the media type that the client expects in the response. Available options: application/json, application/hal+json, application/xml, text/xml, text/csv. The default value is application/json.

Available options:
application/json,
application/hal+json,
application/xml,
text/xml,
text/csv

Path Parameters

aiAgentId
string
required

The Id of the Ai Agent

Required string length: 24
Pattern: ^[a-z0-9]{24}$

Body

application/json
name
string
Example:

"Cognigy AI Agent"

image
string

Avatar of the AI Agent.

Example:

"https://cognigy.com/ai-agent.png"

imageOptimizedFormat
boolean

Whether the optimized image format defined by Cognigy is used.

Example:

true

knowledgeReferenceId
string<uuid> | null

A referenceId of a Knowledge Store this Agent will use as base knowledge or null.

Example:

"c7b3b3b3-3b3b-3b3b-3b3b-3b3b3b3b3b3b"

description
string

A short description of the AI Agent, up to 1000 characters.

Maximum string length: 1000
Example:

"I am a virtual assistant that can help you with your questions."

speakingStyle
object
Example:
voiceConfigs
object
Example:
enableVoiceConfigs
boolean

Enables the use of voice configuration.

Example:

false

enableAutoLanguageDetection
boolean

Whether the AI Agent should automatically detect and respond in the user's language.

Example:

true

safetySettings
object
contactProfilesOption
enum<string>

Option to enable or customize Contact profiles selection for the AI Agent.

Available options:
none,
selectedProfileFields,
completeProfile,
profileMemoriesOnly
Example:

"selectedProfileFields"

contactProfilesSelected
string[]

Selected contact profiles for the AI Agent, it is used only when contactProfilesOption is set to 'selectedProfileFields'.

Example:
instructions
string

Instructions for the AI Agent.

Maximum string length: 1000
Example:

"I can help you with your questions, provide information and much more."

Response

The AI Agent was successfully updated.

Last modified on July 22, 2026