Agent Build

Creates a new agent

Changed on

Creates a new agent in your workspace programmatically.

post/agent/v1/create

Request

  • Base URL
    https://api.langdock.com
  • URL
    https://api.langdock.com/agent/v1/create
  • Auth
    HTTP bearer

Request body

namestring required

Name of the agent or assistant

descriptionstring

Description of what the agent or assistant does. Send an empty string to clear it during an update.

instructionstring

System prompt or instructions. Send an empty string to clear it during an update.

inputType'PROMPT' | 'STRUCTURED' | 'INTEGRATION' | 'SCHEDULED' | 'WEBHOOK'

Input type

emojistring nullable

Emoji icon

modelstring

id from GET /agent/v1/models. Unique deployment names and Anthropic aliases stay valid. When several accessible rows share a name, send the UUID id.

creativitynumber

Temperature for response generation

conversationStartersstring[]

Suggested prompts

webSearchboolean

Enable web search

imageGenerationboolean

Enable image generation

dataAnalystboolean

Deprecated. Accepted for compatibility and ignored.

extendedThinkingboolean

Enable extended thinking

attachmentsstring[]

Attachment UUIDs

knowledgeFolderIdsstring[]

Folder UUIDs

Response

Agent created successfully

status'success' required
messagestring required

Changes