> ## 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. # Atualizar um grupo de espaços de trabalho > Atualize a configuração de um grupo de workspaces existente, incluindo name, description e location. Esta é uma solicitação PUT que implementa substituição completa: todos os campos atualizáveis são obrigatórios. Retorna o recurso atualizado (200) após uma atualização bem-sucedida. ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-v1.json put /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id} openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: API pública REST para portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}: put: tags: - Grupos de workspaces summary: Atualizar um grupo de espaços de trabalho description: >- Atualize a configuração de um grupo de workspaces existente, incluindo name, description e location. Esta é uma solicitação PUT que implementa substituição completa: todos os campos atualizáveis são obrigatórios. Retorna o recurso atualizado (200) após uma atualização bem-sucedida. operationId: updateWorkspaceGroup parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: O identificador único da organização example: 507f1f77bcf86cd799439011 - name: workspace_group_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: O identificador único do grupo de workspaces a ser atualizado example: 507f1f77bcf86cd799439020 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WorkspaceGroupUpdateRequestV1' examples: update-workspace-group-(full-replacement): summary: >- Atualizar grupo de espaços de trabalho com todos os campos necessários value: name: Grupo de Workspace de Produccion Actualizado description: Grupo de workspaces actualizado para entornos de producción location: latitude: 40.4168 longitude: -3.7038 address: Madrid, Espana description: Ubicación de oficina actualizada update-workspace-group-without-location-description: summary: >- Atualizar grupo de espaços de trabalho com campos necessários; a descrição da localização é opcional value: name: Grupo de Workspace de Produccion Actualizado description: Grupo de workspaces actualizado para entornos de producción location: latitude: 40.4168 longitude: -3.7038 address: Madrid, Espana responses: '200': description: >- Grupo de workspaces atualizado corretamente. A resposta contém o recurso atualizado. content: application/json: schema: $ref: '#/components/schemas/WorkspaceGroupDetailResponseV1' '400': $ref: '#/components/responses/BadRequest' description: >- Solicitação incorreta. Causas comuns: - Faltam campos requeridos (name, description, location) - Valores de campo inválidos - Estrutura de localização inválida - Faltam campos obrigatórios de localização (latitude, longitude, address) '401': $ref: '#/components/responses/Unauthorized' description: Não autorizado - é necessária autenticação '404': $ref: '#/components/responses/NotFound' description: Grupo de workspaces não encontrado ou não pertence à organização '409': $ref: '#/components/responses/Conflict' description: Conflito - já existe um grupo de workspaces com o mesmo nome '422': $ref: '#/components/responses/UnprocessableEntity' description: >- Entidade não processável - violação de regra de negócio (ex., não se pode estabelecer filter em um grupo de workspaces de Entra ID) '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: WorkspaceGroupUpdateRequestV1: type: object properties: name: type: string maxLength: 512 description: type: string maxLength: 512 location: $ref: '#/components/schemas/WorkspaceGroupBaseUpdateLocationInputV1' required: - name - description - location WorkspaceGroupDetailResponseV1: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ description: ID do grupo de workspaces name: type: string description: Nome do grupo de workspaces description: type: string nullable: true description: Descrição do grupo de workspaces organization_id: type: string pattern: ^[0-9a-f]{24}$ description: Identificador da organização create_user: type: string nullable: true pattern: ^[0-9a-f]{24}$ description: ID do usuário que criou o grupo de workspaces create_date: type: string format: date-time description: Marca temporal de criação type: type: string nullable: true enum: - static - dynamic - entra_id description: Tipo de grupo de workspaces filter: type: string nullable: true description: Cadeia de filtro para grupo de workspaces dinâmicos location: $ref: '#/components/schemas/WorkspaceLocationV1' nullable: true description: Informação de localização do grupo de workspaces entra_id_source: $ref: '#/components/schemas/WorkspaceGroupEntraIdSourceV1' nullable: true description: Informação de origem do Entra ID para o 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 latitude longitude: type: number description: Coordenada de longitude address: type: string description: Cadeia de endereço description: type: string nullable: true description: Descrição da localização required: - latitude - longitude - address WorkspaceGroupEntraIdSourceV1: type: object properties: resource_id: type: string description: ID de recurso do Entra ID resource_type: type: string enum: - group - administrative_unit description: Tipo de recurso do Entra ID resource_name: type: string description: Nome do recurso do 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: Solicitação incorreta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Não autorizado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: Não encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Conflict: description: Conflito content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UnprocessableEntity: description: Entidade não processável content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Solicitações em excesso content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Erro interno do servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````