> ## Documentation Index > Fetch the complete documentation index at: https://docs.deepslate.eu/llms.txt > Use this file to discover all available pages before exploring further. # Update Agent > Updates an existing agent's configuration. Allows updating details, extensions, and call event hooks. Extensions and hooks can be modified or added (if ID is provided for update, null/missing for creation within the list). ## OpenAPI ````yaml PUT /api/v1/vendors/{vendorId}/organizations/{organizationId}/agents/{agentId} openapi: 3.1.0 info: title: Deepslate description: OpenAPI specification of the public Deepslate API version: v1.0 servers: - url: https://app.deepslate.eu description: Generated server url security: [] tags: - name: SIP Credentials Management description: API endpoints for managing SIP Credentials within an Organization - name: Assistant Management description: API endpoints for managing Assistants within an Organization - name: SIP Numbers Management description: API endpoints for managing SIP Numbers within an Organization - name: Agent Task Management description: API endpoints for retrieving Agent Tasks - name: Organization Management description: API endpoints for managing Organizations - name: Agent Management description: API endpoints for managing Agents within an Organization - name: LLM Generation Strategy Management description: >- API endpoints for managing LLM Generation Strategies within an Organization paths: /api/v1/vendors/{vendorId}/organizations/{organizationId}/agents/{agentId}: put: tags: - Agent Management summary: Update Agent description: >- Updates an existing agent's configuration. Allows updating details, extensions, and call event hooks. Extensions and hooks can be modified or added (if ID is provided for update, null/missing for creation within the list). operationId: updateAgent parameters: - name: vendorId in: path description: ID of the Vendor (UUID) required: true schema: type: string example: a1b2c3d4-e5f6-7890-1234-567890abcdef - name: organizationId in: path description: ID of the Organization (UUID) required: true schema: type: string example: f0e9d8c7-b6a5-4321-fedc-ba9876543210 - name: agentId in: path description: ID of the Agent to update (UUID) required: true schema: type: string example: 98765432-10fe-dcba-9876-543210fedcba requestBody: description: Agent update data content: application/json: schema: $ref: '#/components/schemas/AgentUpdate' required: true responses: '200': description: Agent successfully updated content: application/json: schema: $ref: '#/components/schemas/EmptyResponse' '400': description: Bad Request - Invalid input data '401': description: Unauthorized '403': description: Forbidden - User does not have permission '404': description: Agent, Organization or Vendor not found components: schemas: AgentUpdate: type: object description: Data required to update an existing Agent. properties: name: type: string description: Updated name of the agent. example: Sales Bot Alpha V2 userValueTypes: type: object additionalProperties: type: string enum: - STRING - STRING_REDACTED - INTEGER - FLOAT description: Updated map defining user-specific value types the agent can handle. example: customer_name: STRING product_interest: STRING order_id: NUMBER zip_code: STRING systemPromptTemplate: type: string description: >- Updated template for the system prompt used by the agent's underlying LLM. example: >- You are an expert sales assistant for ACME Corp focusing on upselling existing customers. telephoneNumberId: type: string description: Updated ID of the telephone number assigned to this agent (UUID). example: 22334455-6677-8899-00aa-bbccddeeff11 llmAudioContentGenerationStrategyId: type: string description: >- Updated ID of the LLM Audio Content Generation Strategy used by the agent (UUID). example: bcdef012-3456-789a-bcde-f0123456789a extensions: type: array description: >- Updated list of LLM extensions for this agent. Include existing extension IDs (UUID) to update them, omit ID or provide null to create new ones. items: $ref: '#/components/schemas/AgentUpdateLlmExtension' callEventHooks: type: array description: >- Updated list of Call Event Hooks for this agent. Include existing hook IDs (UUID) to update them, omit ID or provide null to create new ones. items: $ref: '#/components/schemas/AgentUpdateCallEventHook' required: - callEventHooks - extensions - llmAudioContentGenerationStrategyId - name - systemPromptTemplate - telephoneNumberId - userValueTypes EmptyResponse: type: object description: Standard API response wrapper properties: success: type: boolean description: Indicates if the request was successful example: true message: type: string description: Human-readable message data: description: Payload data object example: null timestamp: type: string format: date-time description: Response timestamp in ISO-8601 format example: '2025-04-17T14:23:30Z' traceId: type: string description: Correlation or trace ID required: - success - timestamp AgentUpdateLlmExtension: type: object description: >- Configuration for an LLM Extension during an update operation. ID (UUID) is optional (null/missing to create, present to update). properties: id: type: string description: >- Unique identifier (UUID) of the LLM extension instance to update. If null or missing, a new extension is created. example: deadbeef-cafe-babe-feed-faceabadb001 type: type: string description: >- Type identifier for the LLM extension. Required for both create and update. example: crm_lookup_v1 parameters: type: object additionalProperties: type: object description: >- Specific parameters for this extension instance. Required for both create and update. example: crm_system_url: https://updated-crm.example.com/api api_key_secret: new_secret_crm_key required: - parameters - type AgentUpdateCallEventHook: type: object description: >- Configuration for a Call Event Hook during an update operation. ID (UUID) is optional (null/missing to create, present to update). properties: id: type: string description: >- Unique identifier (UUID) of the call event hook instance to update. If null or missing, a new hook is created. example: b00bface-1337-badd-cafe-d00df00dcafe type: type: string description: >- Type identifier for the call event hook. Required for both create and update. example: webhook_call_ended_v1 parameters: type: object additionalProperties: type: string description: >- Specific parameters for this hook instance. Required for both create and update. example: target_url: https://my.updated-service.com/call_event auth_token: bearer_xyz987 required: - parameters - type ````