# Agenda

Fuente: https://wire.ia.br/documentation/es/api/agenda

> Leer, crear y borrar eventos en la agenda "Paper" de Google Calendar.



La API solo toca la agenda llamada **Paper**, que la propia app crea en el Google Calendar de la persona. Sus otras agendas quedan fuera de alcance.

Antes de usarla:

1. La persona conecta Google Calendar en **Configuración → Integraciones**.
2. En **Configuración → Desarrollador**, toca **Habilitar la agenda "Paper" para la API**.
3. El token necesita el permiso de agenda. Los tokens seguros no acceden a la agenda.

Sin los dos primeros pasos, la API responde `409`.

## Listar eventos [#listar-eventos]

```http
GET /calendar/events?from=2026-10-01&to=2026-10-31
```

`from` y `to` aceptan una fecha o una fecha y hora en ISO 8601. Sin `from`, empieza ahora. Sin `to`, llega hasta 30 días después de `from`. Devuelve hasta 250 eventos, en orden de inicio.

```json
[
  {
    "id": "k9d8f7g6h5j4",
    "titulo": "Dentista",
    "descricao": null,
    "inicio": { "dateTime": "2026-10-06T14:00:00-03:00", "timeZone": "America/Sao_Paulo" },
    "fim": { "dateTime": "2026-10-06T15:00:00-03:00", "timeZone": "America/Sao_Paulo" }
  }
]
```

Los eventos de día completo vienen con `{ "date": "2026-10-06" }` en `inicio` y `fim`.

## Crear un evento [#crear-un-evento]

```http
POST /calendar/events
Content-Type: application/json
```

```json
{
  "title": "Entregar informe",
  "date": "2026-10-08",
  "time": "09:30",
  "durationMinutes": 45,
  "description": "Versión final, con los gráficos.",
  "timeZone": "America/Argentina/Buenos_Aires"
}
```

| Campo             | Obligatorio | Reglas                                                     |
| ----------------- | ----------- | ---------------------------------------------------------- |
| `title`           | No          | Hasta 300 caracteres. Vacío pasa a "Evento".               |
| `date`            | Sí          | `AAAA-MM-DD`.                                              |
| `time`            | No          | `HH:MM`, 24 horas. Sin hora, el evento es de día completo. |
| `durationMinutes` | No          | De 5 a 1440. Por defecto: 60.                              |
| `description`     | No          | Hasta 4000 caracteres.                                     |
| `timeZone`        | No          | Zona horaria IANA. Por defecto: `America/Sao_Paulo`.       |

Respuesta: `{ "id": "…" }`. Necesita el permiso **Leer y crear eventos**.

## Borrar un evento [#borrar-un-evento]

```http
DELETE /calendar/events/{id}
```

Solo borra eventos de la agenda "Paper". Necesita el permiso **Leer y crear eventos**.

## Sentido común [#sentido-común]

Crea eventos que la persona pidió o que vienen de sus notas. No llenes la agenda con recordatorios repetidos ni uses la agenda como cola de tareas de un sistema.