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

# Tasks API

> Crear y gestionar tareas automáticas para tus agentes.

La API de Tasks te permite crear tareas automáticas que ejecutan acciones en tus agentes basadas en triggers (disparadores).

## Tipos de triggers

| Tipo                    | Descripción                                           |
| ----------------------- | ----------------------------------------------------- |
| `schedule`              | Ejecutar en horarios definidos (cron)                 |
| `integration_event`     | Evento de integración externa (Gmail, Calendar, etc.) |
| `webhook`               | Webhook externo                                       |
| `conversation_start`    | Nueva conversación iniciada                           |
| `conversation_resolved` | Conversación marcada como resuelta                    |
| `lead_captured`         | Nuevo lead capturado                                  |
| `form_submitted`        | Formulario completado                                 |

## Endpoints disponibles

<CardGroup cols={2}>
  <Card title="Listar tasks" icon="list" href="/developers/api/tasks/list">
    Obtener todas las tareas de un agente.
  </Card>

  <Card title="Crear task" icon="plus" href="/developers/api/tasks/create">
    Crear una nueva tarea automática.
  </Card>

  <Card title="Obtener task" icon="eye" href="/developers/api/tasks/get">
    Ver detalles de una tarea específica.
  </Card>

  <Card title="Actualizar task" icon="pen" href="/developers/api/tasks/update">
    Modificar configuración de una tarea.
  </Card>

  <Card title="Eliminar task" icon="trash" href="/developers/api/tasks/delete">
    Eliminar una tarea.
  </Card>

  <Card title="Toggle task" icon="toggle-on" href="/developers/api/tasks/toggle">
    Activar o desactivar una tarea.
  </Card>
</CardGroup>

## Ejemplo de uso

```javascript theme={null}
// Crear una tarea programada que ejecuta cada día a las 9am
const response = await fetch('https://app.horneross.com/api/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agentId: 'agent_abc123',
    type: 'schedule',
    name: 'Resumen diario',
    prompt: 'Genera un resumen de las conversaciones de ayer',
    config: {
      cronExpression: '0 9 * * *',
      timezone: 'America/Argentina/Buenos_Aires'
    }
  }),
});
```