Listar destinos en Segment, con una API
Lista los destinos del workspace con id, name, enabled, metadata y el sourceId al que pertenece cada uno. Devuelve los primeros 200, porque la conexión no envía paginación; pagination.totalEntries indica si hay más.
- Identificador
- segment_list_destinations
La llamada
POST https://connect.reportei.com/api/tools/segment_list_destinations/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Esta tool no recibe argumentos.
Conexiones posibles
Tu cliente conecta su cuenta de Segment una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/segment_list_destinations. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Segment
- Listar fuentesGETLista las fuentes del workspace con id, name, slug, enabled, metadata y labels. Devuelve las primeras 200, porque la conexión no envía paginación; pagination.totalEntries indica si hay más.
- Obtener fuenteGETDevuelve una fuente con su configuración, write keys, metadata y labels.
- Listar destinos conectadosGETLista los destinos que reciben datos de una fuente, con id, name, enabled y metadata. Devuelve los primeros 200, porque la conexión no envía paginación.
- Listar warehouses conectadosGETLista los warehouses que reciben datos de una fuente. Devuelve los primeros 200, porque la conexión no envía paginación.
- Obtener destinoGETDevuelve un destino con su configuración, metadata y el sourceId al que pertenece.
- Obtener métricas de entregaGETDevuelve las métricas de entrega de un destino para los eventos de una fuente en un período, cada métrica con su total y desglose. Sin fechas, cubre la última hora por minuto.
- Listar warehousesGETLista los warehouses del workspace con id, enabled, metadata y settings. Devuelve los primeros 200, porque la conexión no envía paginación; pagination.totalEntries indica si hay más.
- Obtener warehouseGETDevuelve un warehouse con su configuración y metadata.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
