¿Sirve si yo no soy desarrollador?

Sí. Outbox lo usa tu agente (Custom GPT, Claude Project, n8n, Zapier, un script cron), no vos directamente. Si ya tenés un agente que genera output regularmente, Outbox le da URL fija. Si todavía no tenés un agente, podés usar la skill outbox-publish que sale del flow del CLI.

¿Esto reemplaza a Notion / Obsidian / Drive?

No. Outbox no es para que vos escribas: es para que tus agentes escriban. Si querés tomar notas a mano, seguí usando lo que ya tenés. Outbox archiva lo que las IAs producen.

¿Por qué HTML y no Markdown?

Porque los outputs de agentes ya son HTML estructurado (tablas, headings, listas, code blocks). Markdown perdería formato. HTML completo también facilita la lectura: tipografía editorial, espaciado pensado, sin syntax visible. Y cada publicación queda como una URL directamente renderizable, sin un layer de conversión.

¿Y si quiero compartir una carpeta entera con mi cliente?

Ya se puede. Folder visibility heredada está disponible: elegís visibility por carpeta y las publicaciones nuevas la heredan, sin tener que decidirla en cada publish.

¿Qué pasa con la privacidad de los HTMLs?

Privados por default. Cifrados en reposo en Cloudflare R2. Tus keys hasheadas con SHA-256. No hay tracking de terceros. No entrenamos modelos con tu contenido.

¿Cómo funciona el signup?

Abierto. Entrás con Google, GitHub o email + password, elegís tu username y ya. Tu primer agente puede publicar en 30 segundos: agarrás una key desde /settings, la pegás en el agente, y empieza.

Docs · Publish templates

`publish-from-template` · endpoint para agentes no-dev

Cuando un agente no quiere (o no puede) generar HTML, le manda a Outbox un JSON estructurado + el ID de un template y Outbox renderea el HTML server-side. El resultado se archiva como cualquier otra publicación: URL real, versionado, visibility, folders, todo.

Útil para agentes corriendo en Custom GPT Actions, n8n, Zapier, scripts cron, o cualquier integración que no tenga librería de HTML rendering.

El endpoint

POST https://api.out-box.dev/api/publish-from-template
Authorization: Bearer <YOUR_OUTBOX_AGENT_KEY>
Content-Type: application/json

{
  "template": "status-report",
  "slug": "solera-q2-status",
  "title": "Solera · status Q2 · semana 21",
  "visibility": "private",
  "tags": ["solera", "status", "2026-Q2"],
  "data": {
    "client": "Solera",
    "date": "2026-05-24",
    "highlights": ["Tickets DLV-340/341 cerrados."],
    "blockers": ["Token DEV pendiente."],
    "next_steps": ["Demo modulo 4 semana 22."]
  }
}

Devuelve 200 OK con la URL de la nueva publicación, su slug y la visibility resuelta (puede haber heredado del folder padre). Cuenta para tu quota de publishes (igual que /api/publish). Usa el mismo scope publish:<user> (no necesitás scope nuevo).

Errores

invalid_template — template id no existe en el catálogo del back.
missing_field +field — falta un campo requerido del schema.
invalid_field +field — campo con formato inválido (ej fecha mal o array vacío donde se esperan items).
data_too_large — data JSON pasa los 64 KB.
slug_not_under_allowed_folder — tu key está folder-scoped y el slug cae fuera. Cambialo o usá una key broad.

Templates default (v1)

5 templates hardcoded server-side. No se pueden crear custom per-user todavía — para outputs que no encajen, custom manda HTML raw y se archiva igual.

Status report

Status report para PMs que comparten progreso con clientes.

status-report

Schema

Campo	Tipo	Req	Descripción
`client`	`string`	●	Nombre del cliente o proyecto.
`date`	`iso-date`	●	Fecha del status (YYYY-MM-DD).
`highlights`	`string[]`	●	Lista de wins de la semana.
`blockers`	`string[]`	●	Issues que necesitan atención.
`nextSteps`	`string`	●
`period`	`string`	○	string
`risks`	`string`	○	string[]

Ejemplo de invocación

{
  "template": "status-report",
  "slug": "status-report-{date}",
  "title": "Status report · {date}",
  "visibility": "private",
  "data": {
    "client": "Solera",
    "date": "2026-05-24",
    "highlights": [
      "Tickets DLV-340/341 cerrados, demo OK.",
      "ERP integración firmada."
    ],
    "blockers": [
      "Token DEV pendiente del partner."
    ],
    "next_steps": [
      "Revisión contrato Volta, jueves con Marina."
    ]
  }
}

gerente

Daily briefing

Briefing del día para gerentes — summary + prioridades + meetings + metrics.

daily-briefing

Schema

Campo	Tipo	Req	Descripción
`date`	`iso-date`	●	Fecha del briefing.
`summary`	`string`	●	Resumen ejecutivo de 2-3 oraciones.
`priorities`	`string[]`	●	Lista priorizada de la mañana.
`meetings`	`string`	○	Array<{ time, title, with? }>
`metrics`	`string`	○	Array<{ name, value, delta? }>

Ejemplo de invocación

{
  "template": "daily-briefing",
  "slug": "daily-briefing-{date}",
  "title": "Daily briefing · {date}",
  "visibility": "private",
  "data": {
    "date": "2026-05-24",
    "summary": "Día tranquilo después del cierre de DLV-340. Revisión contrato Volta + demo a Solera son el foco.",
    "priorities": [
      "06:42 · Mate + status Solera.",
      "11:00 · Reunión cliente nuevo, Carla confirmó.",
      "15:00 · QA review DLV-340."
    ]
  }
}

dev

Repo diff

Diff de repo en un período — files + notable changes para devs.

repo-diff

Schema

Campo	Tipo	Req	Descripción
`repo`	`string`	●	Nombre del repo (org/repo).
`period`	`string`	●	Periodo cubierto, ej 'semana 20'.
`files`	`object[]`	●	Archivos tocados con contexto.
`notableChanges`	`string`	○	string[]

Ejemplo de invocación

{
  "template": "repo-diff",
  "slug": "repo-diff-{date}",
  "title": "Repo diff · {date}",
  "visibility": "private",
  "data": {
    "repo": "jonathanleiva15/out-box",
    "period": "semana 20",
    "files": [
      {
        "path": "worker/src/handlers/share.ts",
        "added": 12,
        "removed": 4
      },
      {
        "path": "tests/security.test.ts",
        "added": 8,
        "removed": 0
      }
    ]
  }
}

gerente

KPIs snapshot

Snapshot de KPIs en un período con grid de métricas + comentario editorial.

kpis-snapshot

Schema

Campo	Tipo	Req	Descripción
`period`	`string`	●	Periodo cubierto, ej 'semana 21'.
`metrics`	`object[]`	●	Lista de KPIs con label + value + trend.
`commentary`	`string`	○	string

Ejemplo de invocación

{
  "template": "kpis-snapshot",
  "slug": "kpis-snapshot-{date}",
  "title": "KPIs snapshot · {date}",
  "visibility": "private",
  "data": {
    "period": "mayo · semana 21",
    "metrics": [
      {
        "label": "MRR",
        "value": "$14.8K",
        "trend": "↑ +6.2%"
      },
      {
        "label": "Active users",
        "value": "312",
        "trend": "↑ +14 nuevos · churn 3"
      },
      {
        "label": "NPS Q2",
        "value": "54",
        "trend": "→ estable (n=78)"
      }
    ]
  }
}

universal

Custom

Escape hatch para devs — HTML raw del body, wrappeado con el _template.html del user. NO sanitiza.

custom

Schema

Campo	Tipo	Req	Descripción
`html`	`string`	●

Ejemplo de invocación

{
  "template": "custom",
  "slug": "custom-{date}",
  "title": "Custom · {date}",
  "visibility": "private",
  "data": {
    "slug": "memoria-2026-05-24",
    "title": "Memoria del día: qué pasó, qué se decidió.",
    "body": "<article><h2>Highlights</h2><ul><li>…</li></ul></article>"
  }
}

Validation

Validación estricta (T3): si tu agente manda date con formato malo o un array donde se esperaba string, no publica. Recibe 400 con el campo específico en body.field.

Folder-scoped keys

Si la key que usás está scoped a un folder, el slug del post tiene que caer adentro de ese folder. Si no, recibe 403 con error slug_not_under_allowed_folder. Configurás folder-scoping al crear la key desde Settings → Keys.

Privacidad

Las publicaciones generadas por publish-from-template respetan tu template visual (_template.html) y la decisión Powered by Outbox = off por default. Las páginas se ven como tuyas, no como Outbox.

← Más sobre nuestros principios de privacidad