Asistentes Documentación del endpoint de Asistentes

Consultar Todos los Asistentes

Este endpoint permite obtener un listado de todos los asistentes disponibles.

Método HTTP

GET

Endpoint URL

'https:tudominio.xfs.cloud/api/v1/xia_assistants'

Nota: Asumiendo que la ruta base de tu API es /api/v1/ y el recurso se llama xia_assistants. Ajusta esta URL según la configuración real de tus rutas.

Formato de Respuesta Exitosa (JSON)

Si la solicitud es exitosa, se obtiene un objeto JSON con la siguiente estructura:


                {
                    "status": "Ok",
                    "data": [
                        {
                            "id": "f5e82310-4341-443e-b3bf-188d85c90515",
                            "orgId": "7dc3cace-f298-4ad4-85d9-54cd98303f60",
                            "name": "Asistente de Ventas",
                            "createdAt": "2025-04-09T19:23:46.211Z",
                            "updatedAt": "2025-05-19T13:27:46.495Z"
                            // ... otros campos resumidos del asistente
                        },
                        {
                            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
                            "orgId": "7dc3cace-f298-4ad4-85d9-54cd98303f60",
                            "name": "Asistente de Soporte",
                            "createdAt": "2025-04-10T10:00:00.000Z",
                            "updatedAt": "2025-05-20T11:00:00.000Z"
                            // ... otros campos resumidos del asistente
                        }
                        // ... más objetos de asistente
                    ],
                    "status_code": 200
                }

Campos clave en cada objeto de `data`:

  • id: (UUID/string) Identificador único del asistente.
  • orgId: (UUID/string) ID de la organización a la que pertenece el asistente.
  • name: (string) Nombre del asistente.
  • createdAt: (timestamp) Fecha y hora de creación del registro.
  • updatedAt: (timestamp) Fecha y hora de la última actualización del registro.
  • (otros campos): Para ver la lista completa de campos de un asistente, consulta la documentación de "GET Asistente Específico". Esta vista de listado puede devolver un subconjunto de los campos para mayor eficiencia.

Consideraciones Adicionales

  • Este endpoint podría soportar paginación si la cantidad de asistentes es muy grande (ej. ?page=2&limit=20).
  • Podrían añadirse parámetros de filtrado y ordenación en el futuro (ej. ?orgId={uuid}, ?sort_by=name).