Update agent

This endpoint updates the agent.

PUT /Agent/{id}

This endpoint updates the agent.

Authentication

Authentication required. Send your user API key in the X-API-Key header.

Parameters

Name	Location	Type	Required	Description	Constraints
`id`	`path`	`integer · int32`	Yes	—	—

Request body

Content type: application/json · Schema: AgentDto

Property	Type	Required	Description	Constraints
`id`	`integer · int32`	No	—	—
`name`	`string`	No	—	nullable
`description`	`string`	No	—	nullable; maxLength: 500
`agentType`	`AgentType`	No	—	—
`agentFilesDtos`	`array<AgentFilesDto>`	No	—	nullable
`enabled`	`boolean`	No	—	—
`isChat`	`boolean`	No	—	—
`instructions`	`string`	No	—	nullable
`model`	`string`	No	—	nullable
`responseFormat`	`string`	No	—	nullable
`vectorStoreId`	`string`	No	—	nullable
`agentAIType`	`AgentAIType`	No	—	—
`temperature`	`number · double`	No	—	nullable
`topP`	`number · double`	No	—	nullable
`integrationAgentId`	`string`	No	—	nullable
`language`	`Language`	No	—	—
`dynamicVariables`	`array<AgentDynamicVariableDto>`	No	—	nullable
`dataCollection`	`array<AgentDataCollectionDto>`	No	—	nullable
`communicationChannel`	`CommunicationChannel`	No	—	—
`firstMessage`	`string`	No	—	nullable; maxLength: 1000
`checklistId`	`integer · int32`	No	—	—
`queueId`	`integer · int32`	No	—	—
`createdAt`	`string · date-time`	No	—	—
`voiceId`	`string`	No	—	nullable
`voiceModel`	`string`	No	—	nullable
`voiceSpeed`	`number · double`	No	—	—
`voiceTemperature`	`number · double`	No	—	—
`volume`	`number · double`	No	—	—
`phoneNumberId`	`string`	No	—	nullable
`phoneNumberType`	`PhoneNumberType`	No	—	—
`customToolsIds`	`array<string>`	No	—	nullable
`builtInTools`	`BuiltInToolsDtos`	No	—	—
`maxDurationSeconds`	`integer · int32`	No	—	—
`elevenLabsReasoningEffort`	`string`	No	—	nullable
`elevenLabsMaxTokens`	`integer · int32`	No	—	—
`elevenLabsAsrProvider`	`string`	No	—	nullable
`elevenLabsTurnEagerness`	`string`	No	—	nullable
`elevenLabsSpellingPatience`	`string`	No	—	nullable
`elevenLabsTurnTimeout`	`number · double`	No	—	—
`elevenLabsSilenceEndCallTimeout`	`number · double`	No	—	—
`groupAgents`	`array<GroupAgentDto>`	No	—	nullable
`currentUserPermission`	`AgentPermissionType`	No	—	—
`agentCategoryId`	`integer · int32`	No	—	—
`logoIconUrl`	`string`	No	—	nullable; maxLength: 2000
`webhookIds`	`array<integer · int32>`	No	—	nullable
`createdByUserId`	`integer · int32`	No	—	—
`ownedByUserId`	`integer · int32`	No	—	—
`defaultQuestions`	`array<string>`	No	—	nullable
`agentKnowledgeIds`	`array<integer · int32>`	No	—	nullable
`agentSkillIds`	`array<integer · int32>`	No	—	nullable

Example request

curl --request PUT \
  --url 'https://api.zild.ai/Agent/{id}' \
  --header 'X-API-Key: YOUR_USER_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "name": "string",
  "description": "string",
  "agentType": 0,
  "agentFilesDtos": [
    {
      "id": "string",
      "fileName": "string"
    }
  ],
  "enabled": true,
  "isChat": true,
  "instructions": "string",
  "model": "string",
  "responseFormat": "string",
  "vectorStoreId": "string",
  "agentAIType": 0,
  "temperature": 0,
  "topP": 0,
  "integrationAgentId": "string",
  "language": 0,
  "dynamicVariables": [
    {
      "id": 0,
      "name": "string",
      "value": "string",
      "agentId": 0
    }
  ],
  "dataCollection": [
    {
      "id": 0,
      "name": "string",
      "value": "string",
      "agentId": 0
    }
  ],
  "communicationChannel": 0,
  "firstMessage": "string",
  "checklistId": 0,
  "queueId": 0,
  "createdAt": "2026-09-22T18:00:00Z",
  "voiceId": "string",
  "voiceModel": "string",
  "voiceSpeed": 0,
  "voiceTemperature": 0,
  "volume": 0,
  "phoneNumberId": "string",
  "phoneNumberType": 0,
  "customToolsIds": [
    "string"
  ],
  "builtInTools": {
    "endCall": {
      "name": "string",
      "params": {
        "systemToolType": "string"
      }
    },
    "transferToNumber": {
      "name": "string",
      "params": {
        "transfers": [
          {
            "condition": null,
            "transferDestination": null,
            "transferType": null
          }
        ]
      }
    }
  },
  "maxDurationSeconds": 0,
  "elevenLabsReasoningEffort": "string",
  "elevenLabsMaxTokens": 0,
  "elevenLabsAsrProvider": "string",
  "elevenLabsTurnEagerness": "string",
  "elevenLabsSpellingPatience": "string",
  "elevenLabsTurnTimeout": 0,
  "elevenLabsSilenceEndCallTimeout": 0,
  "groupAgents": [
    {
      "id": 0,
      "groupId": 0,
      "agentId": 0,
      "permissionType": 0,
      "createdAt": "2026-09-22T18:00:00Z",
      "tenantId": 0
    }
  ],
  "currentUserPermission": 0,
  "agentCategoryId": 0,
  "logoIconUrl": "string",
  "webhookIds": [
    0
  ],
  "createdByUserId": 0,
  "ownedByUserId": 0,
  "defaultQuestions": [
    "string"
  ],
  "agentKnowledgeIds": [
    0
  ],
  "agentSkillIds": [
    0
  ]
}'

Responses

Status	Description	Response body
`200`	Successfully updated the agent	`application/json` · `array<AgentDto>`

Example response (200):

[
  {
    "id": 0,
    "name": "string",
    "description": "string",
    "agentType": 0,
    "agentFilesDtos": [
      {
        "id": "string",
        "fileName": "string"
      }
    ],
    "enabled": true,
    "isChat": true,
    "instructions": "string",
    "model": "string",
    "responseFormat": "string",
    "vectorStoreId": "string",
    "agentAIType": 0,
    "temperature": 0,
    "topP": 0,
    "integrationAgentId": "string",
    "language": 0,
    "dynamicVariables": [
      {
        "id": 0,
        "name": "string",
        "value": "string",
        "agentId": 0
      }
    ],
    "dataCollection": [
      {
        "id": 0,
        "name": "string",
        "value": "string",
        "agentId": 0
      }
    ],
    "communicationChannel": 0,
    "firstMessage": "string",
    "checklistId": 0,
    "queueId": 0,
    "createdAt": "2026-09-22T18:00:00Z",
    "voiceId": "string",
    "voiceModel": "string",
    "voiceSpeed": 0,
    "voiceTemperature": 0,
    "volume": 0,
    "phoneNumberId": "string",
    "phoneNumberType": 0,
    "customToolsIds": [
      "string"
    ],
    "builtInTools": {
      "endCall": {
        "name": "string",
        "params": {
          "systemToolType": "string"
        }
      },
      "transferToNumber": {
        "name": "string",
        "params": {
          "transfers": [
            null
          ]
        }
      }
    },
    "maxDurationSeconds": 0,
    "elevenLabsReasoningEffort": "string",
    "elevenLabsMaxTokens": 0,
    "elevenLabsAsrProvider": "string",
    "elevenLabsTurnEagerness": "string",
    "elevenLabsSpellingPatience": "string",
    "elevenLabsTurnTimeout": 0,
    "elevenLabsSilenceEndCallTimeout": 0,
    "groupAgents": [
      {
        "id": 0,
        "groupId": 0,
        "agentId": 0,
        "permissionType": 0,
        "createdAt": "2026-09-22T18:00:00Z",
        "tenantId": 0
      }
    ],
    "currentUserPermission": 0,
    "agentCategoryId": 0,
    "logoIconUrl": "string",
    "webhookIds": [
      0
    ],
    "createdByUserId": 0,
    "ownedByUserId": 0,
    "defaultQuestions": [
      "string"
    ],
    "agentKnowledgeIds": [
      0
    ],
    "agentSkillIds": [
      0
    ]
  }
]

Data models

AgentAIType

0 = AzureOpenAI; 1 = OpenAI; 2 = RetellAI; 3 = ElevenLabs; 4 = Lovable; 5 = n8n; 6 = Aws; 7 = MicrosoftCopilot; 8 = GoogleGemini; 9 = AnthropicClaude; 10 = Alteryx

integer

AgentDataCollectionDto

Property	Type	Required	Description	Constraints
`id`	`integer · int32`	No	—	—
`name`	`string`	No	—	nullable
`value`	`string`	No	—	nullable
`agentId`	`integer · int32`	No	—	—

AgentDto

Property	Type	Required	Description	Constraints
`id`	`integer · int32`	No	—	—
`name`	`string`	No	—	nullable
`description`	`string`	No	—	nullable; maxLength: 500
`agentType`	`AgentType`	No	—	—
`agentFilesDtos`	`array<AgentFilesDto>`	No	—	nullable
`enabled`	`boolean`	No	—	—
`isChat`	`boolean`	No	—	—
`instructions`	`string`	No	—	nullable
`model`	`string`	No	—	nullable
`responseFormat`	`string`	No	—	nullable
`vectorStoreId`	`string`	No	—	nullable
`agentAIType`	`AgentAIType`	No	—	—
`temperature`	`number · double`	No	—	nullable
`topP`	`number · double`	No	—	nullable
`integrationAgentId`	`string`	No	—	nullable
`language`	`Language`	No	—	—
`dynamicVariables`	`array<AgentDynamicVariableDto>`	No	—	nullable
`dataCollection`	`array<AgentDataCollectionDto>`	No	—	nullable
`communicationChannel`	`CommunicationChannel`	No	—	—
`firstMessage`	`string`	No	—	nullable; maxLength: 1000
`checklistId`	`integer · int32`	No	—	—
`queueId`	`integer · int32`	No	—	—
`createdAt`	`string · date-time`	No	—	—
`voiceId`	`string`	No	—	nullable
`voiceModel`	`string`	No	—	nullable
`voiceSpeed`	`number · double`	No	—	—
`voiceTemperature`	`number · double`	No	—	—
`volume`	`number · double`	No	—	—
`phoneNumberId`	`string`	No	—	nullable
`phoneNumberType`	`PhoneNumberType`	No	—	—
`customToolsIds`	`array<string>`	No	—	nullable
`builtInTools`	`BuiltInToolsDtos`	No	—	—
`maxDurationSeconds`	`integer · int32`	No	—	—
`elevenLabsReasoningEffort`	`string`	No	—	nullable
`elevenLabsMaxTokens`	`integer · int32`	No	—	—
`elevenLabsAsrProvider`	`string`	No	—	nullable
`elevenLabsTurnEagerness`	`string`	No	—	nullable
`elevenLabsSpellingPatience`	`string`	No	—	nullable
`elevenLabsTurnTimeout`	`number · double`	No	—	—
`elevenLabsSilenceEndCallTimeout`	`number · double`	No	—	—
`groupAgents`	`array<GroupAgentDto>`	No	—	nullable
`currentUserPermission`	`AgentPermissionType`	No	—	—
`agentCategoryId`	`integer · int32`	No	—	—
`logoIconUrl`	`string`	No	—	nullable; maxLength: 2000
`webhookIds`	`array<integer · int32>`	No	—	nullable
`createdByUserId`	`integer · int32`	No	—	—
`ownedByUserId`	`integer · int32`	No	—	—
`defaultQuestions`	`array<string>`	No	—	nullable
`agentKnowledgeIds`	`array<integer · int32>`	No	—	nullable
`agentSkillIds`	`array<integer · int32>`	No	—	nullable

AgentDynamicVariableDto

Property	Type	Required	Description	Constraints
`id`	`integer · int32`	No	—	—
`name`	`string`	No	—	nullable
`value`	`string`	No	—	nullable
`agentId`	`integer · int32`	No	—	—

AgentFilesDto

Property	Type	Required	Description	Constraints
`id`	`string`	No	—	nullable
`fileName`	`string`	No	—	nullable

AgentPermissionType

0 = View; 1 = Edit

integer

AgentType

0 = ZildAssist; 1 = ZildFlow; 2 = ZildInsightChat; 3 = ZildChat; 4 = ZildDocs; 5 = ZildVoice; 6 = ZildCoach; 7 = ZildInsightChecklist

integer

BuiltInToolsDtos

Property	Type	Required	Description	Constraints
`endCall`	`EndCall`	No	—	—
`transferToNumber`	`TransferToNumber`	No	—	—

CommunicationChannel

0 = Default; 1 = WhatsApp; 2 = Telefonia; 3 = Email; 4 = WebChat; 5 = InstagramDirectMessage; 6 = FacebookMessenger; 7 = MicrosoftTeams; 8 = ZildCoach

integer

EndCall

Property	Type	Required	Description	Constraints
`name`	`string`	No	—	nullable
`params`	`EndCallParams`	No	—	—

EndCallParams

Property	Type	Required	Description	Constraints
`systemToolType`	`string`	No	—	nullable

GroupAgentDto

Property	Type	Required	Description	Constraints
`id`	`integer · int32`	No	—	—
`groupId`	`integer · int32`	No	—	—
`agentId`	`integer · int32`	No	—	—
`permissionType`	`AgentPermissionType`	No	—	—
`createdAt`	`string · date-time`	No	—	—
`tenantId`	`integer · int32`	No	—	—

Language

0 = PtBr; 1 = EnUS; 2 = EsES; 3 = FrFR; 4 = DeDE; 5 = ItIT; 6 = ZhCN; 7 = ZhTW; 8 = JaJP; 9 = KoKR; 10 = RuRU; 11 = ArSA; 12 = HiIN; 13 = NlNL; 14 = PlPL; 15 = TrTR; 16 = ViVN; 17 = ThTH; 18 = IdID; 19 = SvSE

integer

PhoneNumberType

0 = Twilio; 1 = SipTrunk

integer

TransferDestination

Property	Type	Required	Description	Constraints
`phoneNumber`	`string`	No	—	nullable
`sipUri`	`string`	No	—	nullable
`type`	`string`	No	—	nullable

TransferItem

Property	Type	Required	Description	Constraints
`condition`	`string`	No	—	nullable
`transferDestination`	`TransferDestination`	No	—	—
`transferType`	`string`	No	—	nullable

TransferParams

Property	Type	Required	Description	Constraints
`transfers`	`array<TransferItem>`	No	—	nullable

TransferToNumber

Property	Type	Required	Description	Constraints
`name`	`string`	No	—	nullable
`params`	`TransferParams`	No	—	—