> ## 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.

# Excluir um espaço de trabalho

> Aceita a solicitação de exclusão do espaço de trabalho dentro do escopo de uma organização autorizada e inicia um fluxo assíncrono. A resposta retorna a operação criada, que pode ser consultada posteriormente nos endpoints de operações.



## OpenAPI

````yaml /pt-BR/api-reference/openapi.pt-v1.json delete /v1/organizations/{organization_id}/workspaces/{workspace_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}/workspaces/{workspace_id}:
    delete:
      tags:
        - Workspaces
      summary: Excluir um espaço de trabalho
      description: >-
        Aceita a solicitação de exclusão do espaço de trabalho dentro do escopo
        de uma organização autorizada e inicia um fluxo assíncrono. A resposta
        retorna a operação criada, que pode ser consultada posteriormente nos
        endpoints de operações.
      operationId: delete_workspace_by_id
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador da organização.
          example: 507f1f77bcf86cd799439011
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador do espaço de trabalho.
          example: 64f0c2a1b2d3e4f506070801
      responses:
        '202':
          description: >-
            Solicitação aceita. A operação é retornada para acompanhamento nos
            endpoints de operações.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetOperationByIdResponseV1'
              examples:
                operation_created:
                  summary: Operação criada para a exclusão assíncrona
                  value:
                    id: 64f0c2a1b2d3e4f506070811
                    organization_id: 507f1f77bcf86cd799439011
                    name: delete_workspace
                    description: Operacion de eliminacion de workspace
                    status: pending
                    created_at: '2026-06-05T14:12:00Z'
                    started_at: null
                    ended_at: null
                    microservice_id: null
                    flow_id: null
                    remote_support: null
        '400':
          description: Parâmetros de solicitação inválidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalid_workspace_id:
                  summary: Formato de workspace_id inválido
                  value:
                    error:
                      message: Formato de workspace_id no valido
                      code: bad_request
                      details: >-
                        workspace_id debe ser una cadena hexadecimal en
                        minusculas de 24 caracteres
        '401':
          description: Não autorizado ou a organização não é acessível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                organization_not_authorized:
                  summary: Falha de acesso à organização
                  value:
                    error:
                      message: No autorizado
                      code: unauthorized
        '404':
          description: >-
            Espaço de trabalho não encontrado dentro do escopo autorizado da
            organização.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                workspace_not_found:
                  summary: Espaço de trabalho solicitado não encontrado
                  value:
                    error:
                      message: Workspace no encontrado
                      code: not_found
        '500':
          description: Erro interno do servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unexpected_error:
                  summary: Falha não controlada
                  value:
                    error:
                      message: Error interno del servidor
                      code: internal_error
components:
  schemas:
    GetOperationByIdResponseV1:
      type: object
      properties:
        id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador da execução da operação.
        name:
          type: string
          description: Nome da operação.
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador da organização proprietária da operação.
        description:
          type: string
          description: >-
            Descrição da operação. Retorna uma cadeia vazia quando não existe na
            origem.
        status:
          type: string
          enum:
            - finished
            - unknown
            - error
            - pending
            - in-progress
            - timeout
            - cancelled
            - scheduled
          description: Estado atual da operação.
        created_at:
          type: string
          format: date-time
          description: Marcação temporal de criação.
        started_at:
          type: string
          format: date-time
          nullable: true
          description: Marcação temporal de início.
        ended_at:
          type: string
          format: date-time
          nullable: true
          description: Marcação temporal de finalização.
        microservice_id:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador do microsserviço relacionado, quando existir.
        flow_id:
          type: string
          nullable: true
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Identificador do fluxo relacionado, quando existir.
        remote_support:
          $ref: '#/components/schemas/GetOperationByIdRemoteSupportV1'
      required:
        - id
        - organization_id
        - name
        - description
        - status
        - created_at
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
    GetOperationByIdRemoteSupportV1:
      type: object
      nullable: true
      properties:
        start_date:
          type: string
          format: date-time
          nullable: true
          description: Data de início do suporte remoto.
        end_date:
          type: string
          format: date-time
          nullable: true
          description: Data de término do suporte remoto.
        type:
          type: string
          nullable: true
          description: Tipo de sessão de suporte remoto.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````