Saltar al contenido principal
GET
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de consulta

after
string

ID de conversación para listar conversaciones después (cursor de paginación)

Ejemplo:

"conv_abc123"

limit
integer
predeterminado:20

Número máximo de conversaciones a devolver (1-50, predeterminado 20)

Rango requerido: 1 <= x <= 50
Ejemplo:

20

order
enum<string>
predeterminado:asc

Ordenar por la última fecha de actualización: asc (más antiguo primero) o desc (más reciente primero)

Opciones disponibles:
asc,
desc
Ejemplo:

"desc"

metadata

Filtra conversaciones por pares clave-valor de metadatos (cadena o objeto JSON). Solo se devolverán las conversaciones con metadatos coincidentes.

Ejemplo:

Consulta de búsqueda para encontrar conversaciones por contenido. Utiliza búsqueda de texto completo en los elementos de conversación.

Ejemplo:

"weather forecast"

Respuesta

200 - application/json

Está bien

object
any
requerido
data
object[]
requerido

Array de conversaciones

has_more
boolean
requerido

Si hay más conversaciones

last_id
string

ID de la última conversación en la página actual