Correos

Los mensajes que llegaron a tus inboxes, su contenido interpretado y su estado de procesamiento. Cinco tools.

Ver el modelo Email para la forma del objeto devuelto y la máquina de estados received → approved | rejected → processing → processed | failed.

---

emails_list

Lectura · scope inbox/emails · permiso emails.list · GET /emails

Lista los correos recibidos en el workspace seleccionado. Paginado por cursor. Los cuerpos no se incluyen — para eso usa emails_get.

Parámetro	Tipo	Descripción
cursor	string	Cursor opaco de una página anterior.
limit	integer	Tamaño de página, por defecto 25, máximo 100.
sort	string	Claves de ordenación, prefijo - para descendente.
status	received | approved | rejected | processing | processed | failed	Filtra por estado de procesamiento.
inbox_id	string (uuid)	Solo el correo recibido en este inbox.
agent_id	string (uuid)	Solo el correo procesado por este agente.
message_id	string	Filtra por el Message-ID (RFC 5322).
from	string	Coincidencia exacta en el remitente.
to	string	Coincide cuando la dirección aparece en el array de destinatarios.
created_at_gte / created_at_lte	string	Rango ISO 8601 sobre created_at.
received_at_gte / received_at_lte	string	Rango ISO 8601 sobre received_at.
processed_at_gte / processed_at_lte	string	Rango ISO 8601 sobre processed_at.

emails_get

Lectura · scope inbox/emails · permiso emails.show · GET /emails/{id}

Obtiene un correo, incluidos los cuerpos de texto y HTML ya interpretados.

Parámetro	Tipo	Descripción
id obligatorio	string (uuid)	Id del correo.

emails_download_eml

Lectura · scope inbox/emails · permiso emails.download · GET /emails/{id}/eml

Devuelve una URL prefirmada de vida corta para el .eml original, con todos los headers, partes MIME y adjuntos. La URL expira en 60 segundos y no se puede volver a pedir — descárgala antes de que caduque.

El mensaje en bruto deliberadamente no se devuelve incrustado: el resultado de una tool entra en el contexto del modelo y el cliente puede persistirlo.

Parámetro	Tipo	Descripción
id obligatorio	string (uuid)	Id del correo.

emails_reprocess

Destructiva · scope inbox/emails + write · permiso emails.reprocess · POST /emails/{id}/reprocess

Vuelve a encolar un correo para su agente. Acepta solo approved, processed o failed; cualquier otro estado es 422. Responde 202 — la ejecución ocurre en el worker, no en esta llamada.

Parámetro	Tipo	Descripción
id obligatorio	string (uuid)	Id del correo.
agent_id	string (uuid)	Sustituye el agente para esta ejecución; por defecto, el agente actual del inbox.
idempotency_key	string	Protección contra repeticiones, 8–255 caracteres.

emails_delete

Destructiva · scope inbox/emails + write · permiso emails.delete · DELETE /emails/{id}

Elimina (soft-delete) un correo. El registro deja de aparecer en todas las rutas de lectura.

Parámetro	Tipo	Descripción
id obligatorio	string (uuid)	Id del correo.