> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkeia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar Agente

> Actualiza los datos de un agente.

## Endpoint

`PUT https://gateway.orkeia.ai/agents/{id}`

## Cabeçalhos

```
authorization:  <su_token>
Content-Type: application/json
```

### Parámetros de camino

```json theme={null}
{
  "id": "ID del agente (obligatorio)"
}
```

### Cuerpo de la solicitud

Todos los campos de Agentes, salvo el id, son mutables.

| Campo          | Tipo                                 | Descripción                                                                                                                                                                                   |
| -------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name           | string                               | Nombre del agente                                                                                                                                                                             |
| enabled        | boolean                              | Si el agente está activo                                                                                                                                                                      |
| model          | string / Model                       | id del modelo o modelo de IA                                                                                                                                                                  |
| auto           | boolean                              | Si el agente está activo                                                                                                                                                                      |
| reasoning      | boolean                              | Si el agente tiene permiso para procesar el pensamiento                                                                                                                                       |
| publisher      | string                               | Id de quien creó el agente                                                                                                                                                                    |
| temperature    | number (0.0 hasta 1.0)               | Responsable de controlar la aleatoriedad de las respuestas del modelo. Valores más cercanos a 0 tienden a ser más determinísticos, mientras que más cercanos a 1 tienden a ser más variables. |
| role           | string                               | Papel que el agente desempeñará                                                                                                                                                               |
| objective      | string                               | Objetivo del agente en cada interacción                                                                                                                                                       |
| referencias    | string                               | Referencia textual que el agente utilizará                                                                                                                                                    |
| can.delegate   | boolean                              | ¿Puede el agente delegar tareas?                                                                                                                                                              |
| can.code       | boolean                              | ¿Puede el agente programar?                                                                                                                                                                   |
| multimodal     | boolean                              | ¿Puede el agente interactuar con múltiples modos (imagen, texto, audio)?                                                                                                                      |
| sectors        | array(String)                        | array de sectores que usarán el agente                                                                                                                                                        |
| tools          | array(String) / array(Tools)         | array de herramientas que el agente puede usar                                                                                                                                                |
| knowledgeBases | array(String) / array(KnowledgeBase) | array de bases de conocimiento que podrán ser usadas por el agente                                                                                                                            |

```json theme={null}
{
  "name": "Nuevo nombre del agente",
  "enabled": true
}
```

### Ejemplo (cURL)

```bash theme={null}
curl -X PUT "https://gateway.orkeia.ai/agents/agent123" \
  -H "authorization:  <su_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Nuevo nombre del agente", "enabled": true}'
```

## Respuestas

### Response - Éxito

```json theme={null}
{
"status": "OK",
   "data": { "true" }
}
```

### 500 — Solicitud Incorrecta

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Error del Cliente

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```