Obtiene los mensajes de la conversación
Los 50 mensajes más recientes del hilo principal, en orden cronológico, más los hilos abiertos sobre la conversación.
limit y page recorren el historial hacia atrás: page=2 trae los 50 anteriores a los de page=1, siempre en orden cronológico dentro de la página. threads no se pagina: viene completo en todas las páginas, igual que hoy.
Con paginate=true la respuesta conserva messages y threads y suma data (la misma página que messages), has_more y next_cursor. La primera página son los mensajes más recientes; pasa next_cursor en starting_after para traer los anteriores, hasta que has_more sea false. Un mensaje nuevo no corre las páginas que siguen.
Request
- Base URL: https://api.met.meteor.com.co/api/v1
- URL: https://api.met.meteor.com.co/api/v1/workspaces/{workspaceId}/conversations/{convId}/messages
- Auth: one of:
- bearer (a scheme the document does not define)
- HTTP bearer
Path parameters
ID numérico del workspace. Debe ser el mismo workspace de tu API key: pedir otro devuelve 401.
ID numérico de la conversación.
Query parameters
En la forma de siempre, cuántos elementos trae la página (1–200); con page pero sin limit se usan 50. Omítelo junto con page para recibir exactamente lo de siempre. Con paginate=true o starting_after: 1–100, y sin él se usan 20.
Qué página quieres en la forma de siempre, empezando en 1; la señal de fin es la página vacía. No aplica con paginate=true: ahí se avanza con starting_after.
Con true la respuesta llega como { data, has_more, next_cursor } en vez de la forma de siempre. Sin este parámetro (ni starting_after) la respuesta es exactamente la de hoy.
Cursor opaco: el next_cursor de la página anterior, tal cual llegó. Mandarlo también activa la forma { data, has_more, next_cursor }. Uno que no se entiende responde 400 validation_error con param: starting_after.
Response
Sin paginate ni starting_after, la forma de siempre. Con ellos, { data, has_more, next_cursor }.
Example response
{
"data": {
"messages": [
{
"content": "Listo, agendé el recordatorio para mañana.",
"conversation_id": 1842,
"created_at": "2026-07-30T04:12:33.120Z",
"id": 90312,
"role": "assistant"
}
],
"threads": [
{
"context_id": 9812,
"context_type": "item",
"conversation_id": 1842,
"id": 771,
"title": "Propuesta Acme"
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.