> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear un enlace mágico de descarga de agente

> Crea un enlace mágico para descargar el instalador del agente en un grupo de reporte. Esta funcionalidad solo está disponible para el producto FXXOne. Ponte en contacto con el equipo de Flexxible para más información.



## OpenAPI

````yaml /api-reference/openapi-v1.json post /v1/organizations/{organization_id}/reporting-groups/{reporting_group_id}/magic-links
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 1.0.0
  description: Api publica REST para portal
servers:
  - url: https://api.staging.flxwvdexternal.com
    description: Staging API server
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/reporting-groups/{reporting_group_id}/magic-links:
    post:
      tags:
        - Grupos de reporte
      summary: Crear un enlace mágico de descarga de agente
      description: >-
        Crea un enlace mágico para descargar el instalador del agente en un
        grupo de reporte. Esta funcionalidad solo está disponible para el
        producto FXXOne. Ponte en contacto con el equipo de Flexxible para más
        información.
      operationId: createReportingGroupMagicLink
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: El identificador único de la organización
          example: 507f1f77bcf86cd799439011
        - name: reporting_group_id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: El identificador único del Grupo de reporte
          example: 507f1f77bcf86cd799439020
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateReportingGroupMagicLinkRequestV1'
            examples:
              default-installer:
                summary: Crear enlace mágico usando valores estrictos del instalador
                value:
                  expires_at: '2026-03-15T12:00:00.000Z'
                  installer:
                    version: latest
                    platform: windows
                    arch: x64
                    type: fxxone
      responses:
        '201':
          description: Enlace mágico creado correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateReportingGroupMagicLinkResponseV1'
              examples:
                created-magic-link:
                  summary: Respuesta de enlace mágico creado
                  value:
                    id: 507f1f77bcf86cd799439099
                    token: 2ab46558-3c40-4b72-8fce-08b7b596f624
                    link: >-
                      https://portal.example.com/magic-link?key=2ab46558-3c40-4b72-8fce-08b7b596f624
        '400':
          $ref: '#/components/responses/BadRequest'
          description: >-
            Solicitud incorrecta: parámetros de ruta, cuerpo de solicitud o
            formato de fecha-hora no válidos.
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: 'No autorizado: autenticación requerida'
        '404':
          $ref: '#/components/responses/NotFound'
          description: Grupo de reporte no encontrado
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
          description: >-
            Entidad no procesable: la validación de negocio falló (por ejemplo,
            una expiración fuera del rango permitido).
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    CreateReportingGroupMagicLinkRequestV1:
      type: object
      additionalProperties: false
      properties:
        expires_at:
          type: string
          format: date-time
          description: >-
            Fecha y hora de expiración en UTC (ISO 8601, por ejemplo, con sufijo
            Z). Debe estar en el futuro y no más de 91 días por delante.
          example: '2026-03-15T12:00:00.000Z'
        installer:
          $ref: '#/components/schemas/ReportingGroupMagicLinkInstallerV1'
      required:
        - expires_at
        - installer
      description: Cuerpo de solicitud para crear un enlace mágico de Grupo de reporte.
    CreateReportingGroupMagicLinkResponseV1:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          description: Identificador del enlace mágico
          example: 507f1f77bcf86cd799439099
        token:
          type: string
          description: Token asociado con el enlace mágico.
          example: 2ab46558-3c40-4b72-8fce-08b7b596f624
        link:
          type: string
          description: URL del enlace mágico.
          example: >-
            https://portal.example.com/magic-link?key=2ab46558-3c40-4b72-8fce-08b7b596f624
      required:
        - id
        - token
        - link
    ReportingGroupMagicLinkInstallerV1:
      type: object
      additionalProperties: false
      properties:
        version:
          type: string
          enum:
            - latest
          description: Versión del instalador.
          example: latest
        platform:
          type: string
          enum:
            - windows
          description: Plataforma del instalador.
          example: windows
        arch:
          type: string
          enum:
            - x64
          description: Arquitectura del instalador.
          example: x64
        type:
          type: string
          enum:
            - fxxone
          description: Tipo de instalador.
          example: fxxone
      required:
        - version
        - platform
        - arch
        - type
      description: Selección de instalador para el enlace mágico.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
  responses:
    BadRequest:
      description: Solicitud incorrecta
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: No autorizado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: No encontrado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    UnprocessableEntity:
      description: Entidad no procesable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Demasiadas solicitudes
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Error interno del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````