> ## 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 grupo de workspaces

> Crea un nuevo grupo de workspaces para la organización especificada. Actualmente solo se admiten grupos de workspaces de tipo STATIC. Devuelve el ID del grupo de workspaces creado tras una creación exitosa.



## OpenAPI

````yaml /api-reference/openapi-v1.json post /v1/organizations/{organization_id}/workspace-groups
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}/workspace-groups:
    post:
      tags:
        - Grupos de workspaces
      summary: Crear un grupo de workspaces
      description: >-
        Crea un nuevo grupo de workspaces para la organización especificada.
        Actualmente solo se admiten grupos de workspaces de tipo STATIC.
        Devuelve el ID del grupo de workspaces creado tras una creación exitosa.
      operationId: createWorkspaceGroup
      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
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspacegroupsCreateRequestV1'
            examples:
              create-static-workspace-group:
                summary: >-
                  Crear un grupo de workspaces con los campos obligatorios
                  mínimos
                value:
                  name: Grupo de Workspaces de producción
              create-workspace-group-with-description:
                summary: Crear un grupo de workspaces con descripción
                value:
                  name: Grupo de Workspaces de desarrollo
                  description: Grupo de workspaces para entornos de desarrollo
                  type: static
              create-workspace-group-with-location:
                summary: Crear un grupo de workspaces con información de ubicación
                value:
                  name: Grupo de Workspaces de la oficina de Madrid
                  description: Grupo de workspaces para la oficina de Madrid
                  type: static
                  location:
                    latitude: 40.4168
                    longitude: -3.7038
                    address: Madrid, España
                    description: Ubicación de la oficina principal
      responses:
        '201':
          description: >-
            Grupo de workspaces creado correctamente. La respuesta contiene el
            recurso creado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceGroupDetailResponseV1'
        '400':
          $ref: '#/components/responses/BadRequest'
          description: >-
            Solicitud incorrecta. Causas comunes: - Faltan campos obligatorios -
            Valores de campo no válidos - Valor de tipo no válido (solo se
            permite STATIC) - Estructura de ubicación no válida
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: No autorizado - se requiere autenticación
        '404':
          $ref: '#/components/responses/NotFound'
          description: Organización no encontrada
        '409':
          $ref: '#/components/responses/Conflict'
          description: 'Conflicto: ya existe un grupo de workspaces con el mismo nombre'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    WorkspacegroupsCreateRequestV1:
      type: object
      properties:
        name:
          type: string
          maxLength: 512
        description:
          type: string
          maxLength: 512
        type:
          type: string
          enum:
            - static
          default: static
        location:
          $ref: '#/components/schemas/WorkspaceGroupBaseUpdateLocationInputV1'
      required:
        - name
    WorkspaceGroupDetailResponseV1:
      type: object
      properties:
        id:
          type: string
          pattern: ^[0-9a-f]{24}$
          description: ID del grupo de workspaces
        name:
          type: string
          description: Nombre del grupo de workspaces
        description:
          type: string
          nullable: true
          description: Descripción del grupo de workspaces
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          description: Identificador de organización
        create_user:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          description: ID del usuario que creó el grupo de workspaces
        create_date:
          type: string
          format: date-time
          description: Marca de tiempo de creación
        type:
          type: string
          nullable: true
          enum:
            - static
            - dynamic
            - entra_id
          description: Tipo de grupo de workspaces
        filter:
          type: string
          nullable: true
          description: Cadena de filtro para grupo de workspaces dinámicos
        location:
          $ref: '#/components/schemas/WorkspaceLocationV1'
          nullable: true
          description: Información de ubicación del grupo de workspaces
        entra_id_source:
          $ref: '#/components/schemas/WorkspaceGroupEntraIdSourceV1'
          nullable: true
          description: Información de origen de Entra ID para el grupo de workspaces
      required:
        - id
        - name
        - organization_id
        - create_date
    WorkspaceGroupBaseUpdateLocationInputV1:
      type: object
      properties:
        latitude:
          type: number
        longitude:
          type: number
        address:
          type: string
          maxLength: 512
        description:
          type: string
          maxLength: 512
      required:
        - latitude
        - longitude
        - address
    WorkspaceLocationV1:
      type: object
      properties:
        latitude:
          type: number
          description: Coordenada de latitud
        longitude:
          type: number
          description: Coordenada de longitud
        address:
          type: string
          description: Cadena de dirección
        description:
          type: string
          nullable: true
          description: Descripción de la ubicación
      required:
        - latitude
        - longitude
        - address
    WorkspaceGroupEntraIdSourceV1:
      type: object
      properties:
        resource_id:
          type: string
          description: ID de recurso de Entra ID
        resource_type:
          type: string
          enum:
            - group
            - administrative_unit
          description: Tipo de recurso de Entra ID
        resource_name:
          type: string
          description: Nombre del recurso de Entra ID
      required:
        - resource_id
        - resource_type
        - resource_name
    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'
    Conflict:
      description: Conflicto
      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

````