PATCH
/
agents
/
{id}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

ID of the agent to be updated.

Body

application/json
name
string

New name for the agent.

description
string

New description for the agent.

modelName
string

New LLM model to be used by the agent. Check the API for available model names.

temperature
number

New model temperature (min 0.0, max 1.0).

systemPrompt
string

New system prompt for the agent.

visibility
enum<string>

New visibility for the agent.

Available options:
public,
private
handle
string

New unique identifier (slug) for the agent.

interfaceConfig
object

New chat interface settings for this agent. Replaces the existing object.

configUrlExternal
object

New external URL configurations. Replaces the existing object.

configUrlInfosSystemExternal
object

New external URL configurations of the system. Replaces the existing object.

tools
object[]

List of tools for the agent. This array defines the final state of the tools.

  • Tools in the array without an id will be created.
  • Tools in the array with an existing id will be updated (only config is updatable for http, form, lead_capture types).
  • Existing tools in the agent that are not present in this array will be removed.

Response

200 - application/json
id
string
name
string
description
string | null
modelName
string

LLM - Model name.

temperature
number

Temperature of the model (min 0.0, max 1.0)

visibility
enum<string>
Available options:
public,
private
systemPrompt
string | null

Agent system prompt