# Agendar posts

Adicione `scheduled_at` com data, hora e **fuso horário** (formato ISO 8601). Sem esse campo, o post é publicado na hora.

```
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Abrimos sábado às 9","platforms":["instagram","facebook"],"media":[{"url":"https://picsum.photos/seed/abre/1080/1080"}],"scheduled_at":"2026-11-07T09:00:00-03:00"}'
```

A resposta traz `"status": "scheduled"`. Consulte o status com `GET /v1/posts/{id}`: ele muda para `published` (ou `failed`, com o motivo por rede) quando chega a hora.

## Fuso horário

Use sempre o deslocamento: `-03:00` para São Paulo, Rio de Janeiro e Buenos Aires, `-04:00` para Manaus, `-06:00` para a Cidade do México, `-05:00` para Bogotá e Lima. Uma data sem fuso horário é rejeitada com `validation_error`.

## Pelo MCP

Peça ao seu agente: *"Agende para segunda às 10, horário de Brasília"*. A ferramenta `wyro_publicar` usa o campo `programar_para`.

## Pelo CLI

```
npx @wyroapi/wyro publicar "Abrimos sábado" --red instagram --medio https://… --programar 2026-11-07T09:00:00-03:00
```
