Saltar al contenido principal
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

agent_id
string
requerido

Cuerpo

application/json
name
string
Required string length: 1 - 120
description
string | null
Maximum string length: 2000
model
string
Minimum string length: 1
Ejemplo:

"functionary-pt"

instructions
string | null
Maximum string length: 20000
tools
object[]
tool_choice
parallel_tool_calls
boolean
max_tool_calls
integer | null
Rango requerido: 1 <= x <= 300
text
object | null
reasoning
object | null
metadata
object

Respuesta

Agente actualizado.

object
enum<string>
requerido
Opciones disponibles:
agent
id
string
requerido
name
string
requerido
description
string | null
requerido
model
string
requerido
Ejemplo:

"functionary-pt"

instructions
string | null
requerido
tools
object[]
requerido
tool_choice
requerido
parallel_tool_calls
boolean
requerido
max_tool_calls
integer | null
requerido
text
object | null
requerido
reasoning
object | null
requerido
metadata
object
requerido
version
integer
requerido

Versión de configuración actual. Incrementada en cada actualización o retroceso.

Rango requerido: x >= 1
created_at
string<date-time>
requerido
updated_at
string<date-time>
requerido
deleted_at
string<date-time> | null
requerido