Update agent (new revision)

put

https://api.agent700.ai/api/agents/{agentId}

Creates a new revision of an existing agent. If the agent does not exist for the current user, a new agent may be created.

JSON Structured Output can be enabled or disabled via the jsonOutputEnabled and jsonSchema fields. When enabling, provide a valid JSON Schema Draft 7 string. When disabling, set jsonOutputEnabled: false and jsonSchema: null.

Path Params

agentId

string

required

Agent GUID

Body Params

Agent update data. Creates a new revision of the existing agent. All fields are optional and will use defaults if not provided. If the agent doesn't exist for the current user, a new agent may be created. Requires a valid paid account (payment_required middleware).

organizationId

string

required

name

string

masterPrompt

string

introductoryText

string

imageDimensions

string

model

string

temperature

number

topP

number

maxTokens

integer

piiThreshold

number

scrubPii

boolean

smartDocEvaluation

boolean

smartDocChunkSize

integer

smartDocChunkOverlap

integer

smartDocEmbeddingModel

string

smartDocTopK

integer

fullDocAnalysis

boolean

fullDocChunkSize

integer

fullDocChunkOverlap

integer

fullDocMaxLength

integer

enableMcp

boolean

mcpServerNames

array of strings

mcpServerNames

mcpAutoApprove

boolean

jsonOutputEnabled

boolean

Defaults to false

Enables JSON Structured Output. Not available for image generation models. When true, a valid jsonSchema must be provided.

jsonSchema

string | null

JSON Schema (Draft 7) string defining expected output structure. Required when jsonOutputEnabled is true; null when disabled.

customShareUrl

string | null

allowPublicSharing

boolean

hasPhoneNumber

boolean

Responses

Language

Credentials

Bearer

JWT

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Agent updated

403Access denied