> ## Documentation Index
> Fetch the complete documentation index at: https://docsnewgen.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-v2.json post /v2/organizations/{organization_id}/workspace-groups
openapi: 3.0.3
info:
  title: API Pública Portal
  version: 2.0.0
  description: API pública REST para Portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags:
  - name: Actividad digital
    description: Creación de grupos de procesos core por organización
  - name: Roles
    description: Endpoint de creaciÓn de roles de organización
  - name: Usuarios
    description: Endpoint de creación de usuarios de organización
  - name: Grupos de workspaces
    description: Endpoints de gestión de grupos de workspaces
  - name: Workspaces
    description: Endpoint de eliminacion de workspaces de la organización
  - name: Aplicaciones instaladas
    description: Endpoint de detalle de aplicación instalada de la organización
  - name: Autenticación
    description: Endpoints de autenticación y contexto de sesión
  - name: Microservicios
    description: Detalle de microservicios por organización
  - name: Operaciones
    description: Consulta de detalle de operaciones por organización
  - name: Organización
    description: Operaciones de organización
  - name: Objetivos de política de parches
    description: Endpoints de gestión de objetivos de política de parches
  - name: Configuraciones de producto
    description: Endpoints de gestión de configuraciones de producto
  - name: Grupos de reporte
    description: Operaciones sobre grupos de reporte
  - name: Sesiones
    description: Endpoint de detalle de sesión de la organización
  - name: Tenants
    description: Endpoints de gestión de tenants
paths:
  /v2/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/WorkspacegroupsCreateRequestV2'
            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/WorkspaceGroupDetailResponseV2'
        '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:
    WorkspacegroupsCreateRequestV2:
      type: object
      properties:
        name:
          type: string
          maxLength: 512
        description:
          type: string
          maxLength: 512
        type:
          type: string
          enum:
            - static
          default: static
        location:
          $ref: '#/components/schemas/WorkspaceGroupBaseUpdateLocationInputV2'
      required:
        - name
    WorkspaceGroupDetailResponseV2:
      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
        created_by:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          description: ID del usuario que creó el grupo de workspaces
        created_at:
          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/WorkspaceLocationV2'
          nullable: true
          description: Información de ubicación del grupo de workspaces
        entra_id_source:
          $ref: '#/components/schemas/WorkspaceGroupEntraIdSourceV2'
          nullable: true
          description: Información de origen de Entra ID para el grupo de workspaces
      required:
        - id
        - name
        - organization_id
        - created_at
    WorkspaceGroupBaseUpdateLocationInputV2:
      type: object
      properties:
        latitude:
          type: number
        longitude:
          type: number
        address:
          type: string
          maxLength: 512
        description:
          type: string
          maxLength: 512
      required:
        - latitude
        - longitude
        - address
    WorkspaceLocationV2:
      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
    WorkspaceGroupEntraIdSourceV2:
      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

````