> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar conexiones sin asignar > Usa este endpoint para listar las conexiones que aún no se han asignado a un producto. Es útil sobre todo durante una migración: las conexiones creadas antes de que existiera la asignación por producto no tienen producto, y este endpoint te permite encontrarlas para que puedas asociar cada una a un producto mediante el endpoint [Asignar una conexión a un producto](/es/reference/reporter/connections/assign-connection). ## OpenAPI ````yaml es/openapi/v3-current/connections.yaml get /v1/management/connections/unassigned openapi: 3.1.0 info: title: Conexiones de Base de Datos description: >- La API de conexiones de base de datos proporciona endpoints para gestionar las conexiones de base de datos utilizadas por Reporter. Le permite crear, listar, actualizar, eliminar y probar conexiones de base de datos, así como validar esquemas frente a las fuentes de datos configuradas. version: 1.0.0 servers: - url: https://reporter.sandbox.lerian.net security: [] tags: - name: Database Connections description: >- Endpoints para gestionar las conexiones de base de datos utilizadas por Reporter. paths: /v1/management/connections/unassigned: get: tags: - Database Connections summary: Listar conexiones sin asignar description: >- Usa este endpoint para listar las conexiones que aún no se han asignado a un producto. Es útil sobre todo durante una migración: las conexiones creadas antes de que existiera la asignación por producto no tienen producto, y este endpoint te permite encontrarlas para que puedas asociar cada una a un producto mediante el endpoint [Asignar una conexión a un producto](/es/reference/reporter/connections/assign-connection). parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/SortOrder' responses: '200': description: La lista de conexiones que no tienen ningún producto asignado. content: application/json: schema: $ref: '#/components/schemas/ConnectionListResponse' example: page: 1 limit: 50 total: 1 items: - id: 019996b8-f3d1-7d2b-a192-6e91464d82fc configName: legacy-transactional-db productName: '' type: POSTGRESQL host: postgres.cliente.com.br port: 5432 databaseName: transaction userName: user_legacy_read schema: public ssl: mode: require metadata: {} createdAt: '2025-09-25T10:30:00Z' updatedAt: '2025-09-25T10:30:00Z' '400': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error0405: $ref: '#/components/examples/Error0405' Error0406: $ref: '#/components/examples/Error0406' Error0407: $ref: '#/components/examples/Error0407' '500': description: '' content: application/json: schema: $ref: '#/components/schemas/Error' examples: Error0002: $ref: '#/components/examples/Error0002' security: [] components: parameters: Authorization: name: Authorization in: header description: >- El token de autorización en el formato `Bearer `. **Importante:** Este encabezado es obligatorio si su entorno tiene Access Manager habilitado. Para más información, consulte la documentación de [Access Manager](/es/platform/access-manager/access-manager). required: false schema: type: string example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Page: name: page in: query description: El número de página que se desea consultar (con índice basado en 1). required: false schema: type: integer minimum: 1 default: 1 example: 1 Limit: name: limit in: query description: >- Número máximo de elementos devueltos por página (máximo 1000). Su valor predeterminado es 10 cuando se omite. required: false schema: type: integer minimum: 1 maximum: 1000 default: 10 example: 10 SortOrder: name: sortOrder in: query description: El orden utilizado para ordenar los resultados. required: false schema: type: string enum: - asc - desc default: desc example: desc schemas: ConnectionListResponse: type: object description: Lista paginada de conexiones. required: - items - page - limit - total properties: page: type: integer description: >- Número de página actual en los resultados paginados (con índice basado en 1). example: 1 limit: type: integer description: Número máximo de elementos devueltos por página. example: 50 total: type: integer description: Recuento total de elementos disponibles en todas las páginas. example: 3 items: type: array description: Arreglo que contiene las conexiones de la página actual. maxItems: 100 items: $ref: '#/components/schemas/ConnectionResponse' Error: type: object description: >- Mensaje de error de la respuesta. Los códigos de error utilizan el prefijo `FET` para identificar problemas relacionados con la API de conexiones de base de datos. required: - code - title - message properties: code: type: string description: >- Un identificador único y estable para el error (con el prefijo `FET`). example: FET-0001 title: type: string description: Un breve resumen del problema. example: Missing required fields message: type: string description: Orientación detallada para resolver el error. example: >- One or more required fields are missing. Please ensure all required fields like configName, host, port, userName, and password are included. ConnectionResponse: type: object description: Objeto de respuesta que contiene los detalles de la conexión. required: - id - configName - type - host - port - databaseName - userName - createdAt properties: id: type: string format: uuid description: Identificador único de la conexión (formato UUID). example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 productName: type: string description: >- El nombre de producto asociado a esta conexión. Puede estar vacío si la conexión no se ha asignado a ningún producto. example: my-product configName: type: string description: Nombre identificador único de esta configuración de conexión. example: production-db type: type: string description: >- Tipo de motor de base de datos. Valores admitidos: `ORACLE`, `SQL_SERVER`, `POSTGRESQL`, `MONGODB`, `MYSQL`. Tenga en cuenta que el campo `type` de la fuente de datos en el endpoint [Listar Fuentes de Datos](/es/reference/reporter/list-data-sources) devuelve identificadores en minúsculas (`postgresql`, `mongodb`). enum: - ORACLE - SQL_SERVER - POSTGRESQL - MONGODB - MYSQL example: POSTGRESQL host: type: string description: Nombre de host o dirección IP del servidor de base de datos. example: db.example.com port: type: integer description: Número de puerto de red para la conexión de base de datos. example: 5432 databaseName: type: string description: >- Nombre de la base de datos a la que conectarse en el servidor de destino. example: mydatabase userName: type: string description: >- Credencial de nombre de usuario para la autenticación de la base de datos. example: dbuser schema: type: string description: Nombre del esquema de base de datos, cuando está definido. example: public ssl: $ref: '#/components/schemas/SSLResponse' metadata: $ref: '#/components/schemas/Metadata' createdAt: type: string format: date-time description: Marca de tiempo ISO 8601 que indica cuándo se creó la conexión. example: '2024-01-15T10:30:00Z' updatedAt: type: string format: date-time description: >- Marca de tiempo ISO 8601 que indica cuándo se actualizó la conexión por última vez. example: '2024-01-15T10:30:00Z' SSLResponse: type: object description: >- Configuración SSL devuelta en las respuestas de conexión. Solo se expone el `mode` de SSL; el material del certificado (`ca`, `cert`, `key`) nunca se devuelve. properties: mode: type: string description: Modo de conexión SSL configurado para esta conexión. enum: - disable - require - verify-ca - verify-full example: require Metadata: type: object additionalProperties: type: string maxLength: 2000 description: >- Un objeto que contiene pares clave-valor para almacenar información adicional relacionada con la conexión. Las claves (máximo 100 caracteres) y los valores (máximo 2000 caracteres) deben ser cadenas de texto. No se permiten objetos anidados. example: environment: production team: data-engineering examples: Error0405: summary: Invalid Query Parameter value: code: FET-0405 title: Invalid Query Parameter message: >- One or more query parameters are in an incorrect format. Please check the following parameters and ensure they meet the required format before trying again. Error0406: summary: Pagination Limit Exceeded value: code: FET-0406 title: Pagination Limit Exceeded message: >- The pagination limit exceeds the maximum allowed of 1000 items per page. Please verify the limit and try again. Error0407: summary: Invalid Sort Order value: code: FET-0407 title: Invalid Sort Order message: >- The 'sortOrder' field must be 'asc' or 'desc'. Please provide a valid sort order and try again. Error0002: summary: Internal Server Error value: code: FET-0002 title: Internal Server Error message: >- The server encountered an unexpected error. Please try again later or contact support. ````