Update an existing Assistant programmatically
Updates an existing Assistant in your workspace. Only the fields you provide will be updated, allowing for partial updates without affecting other configuration.Documentation Index
Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
Use this file to discover all available pages before exploring further.
AGENT_API scope and access to the Assistant you want to update.actions, inputFields, conversationStarters, and attachments completely replace existing values when provided[] to remove all actions/fields/attachmentsnull for emoji to clear it. For description and instruction, send an empty string "" to clear themassistantId is required.
| Parameter | Type | Required | Description |
|---|---|---|---|
assistantId | string | Yes | UUID of the assistant to update |
name | string | No | Assistant name (1-80 characters) |
description | string | No | Description (max 500 chars, "" to clear) |
emoji | string | No | Emoji icon (null to clear) |
instruction | string | No | System prompt (max 40000 chars, "" to clear) |
model | string | No | Model UUID |
creativity | number | No | Temperature between 0 and 1 |
conversationStarters | string[] | No | Suggested prompts (replaces existing) |
actions | array | No | Actions (replaces existing) |
inputFields | array | No | Form fields (replaces existing) |
attachments | string[] | No | Attachment UUIDs (replaces existing) |
webSearch | boolean | No | Enable web search |
imageGeneration | boolean | No | Enable image generation |
dataAnalyst | boolean | No | Enable code interpreter |
canvas | boolean | No | Enable canvas |
extendedThinking | boolean | No | Enable extended thinking mode |
actions array should contain:
actionId (required) - UUID of the action from an enabled integrationrequiresConfirmation (optional) - Whether to require user confirmation before executinginputFields array structure, see the Create Assistant API documentation.
actions or attachments, always include existing items you want to keep, as the entire array is replaced.agentId instead of assistantIdAPI key as Bearer token. Format "Bearer YOUR_API_KEY"
UUID of the agent to update
Updated name
1 - 255Updated description (null to clear)
256Updated emoji icon (null to clear)
Updated system prompt (null to clear)
16384Updated input type for the agent
PROMPT, STRUCTURED Model ID to use (see Models for Agent API)
Updated temperature
0 <= x <= 1Updated array of suggested prompts (replaces existing)
Updated array of actions (replaces existing)
Updated array of form fields (replaces existing)
Updated array of attachment UUIDs (replaces existing)
Updated web search capability setting
Updated image generation capability setting
Updated code interpreter capability setting
Updated canvas capability setting