Webex Workspaces API

The Workspaces API from Webex — 3 operation(s) for workspaces.

OpenAPI Specification

webex-workspaces-api-openapi.yml Raw ↑
openapi: 3.0.0
info:
  title: Webex Admin Address Book Workspaces API
  version: 1.0.0
  description: The Webex Admin APIs provide comprehensive programmatic access to administrative functions for managing Webex organizations, users, licenses, and settings. These APIs enable automation of user provisioning, license assignment, compliance management, and audit event retrieval. Administrators can integrate with enterprise identity systems, enforce security policies, monitor usage, and streamline onboarding/offboarding processes. The APIs support granular control over organizational resources, making them ideal for large-scale deployments and custom admin tooling.
tags:
- name: Workspaces
paths:
  /workspaces:
    get:
      responses:
        '200':
          description: OK
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceCollectionResponse'
              example:
                items:
                - id: Y2lzY28zcGFyazovL3VzL1BMQUNFUy81MTAxQjA3Qi00RjhGLTRFRjctQjU2NS1EQjE5QzdCNzIzRjc
                  orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8xZWI2NWZkZi05NjQzLTQxN2YtOTk3NC1hZDcyY2FlMGUxMGY
                  locationId: Y2lzY29z...
                  workspaceLocationId: YL34GrT...
                  floorId: Y2lzY29z...
                  displayName: SFO-12 Capanina
                  capacity: 5
                  type: notSet
                  sipAddress: test_workspace_1@trialorg.room.ciscospark.com
                  created: '2016-04-21T17:00:00.000Z'
                  calling:
                    type: hybridCalling
                    hybridCalling:
                      emailAddress: workspace@example.com
                    webexCalling:
                      licenses:
                      - Y2lzY29g4...
                  notes: this is a note
                  hotdeskingStatus: 'on'
                  supportedDevices: collaborationDevices
                  calendar:
                    type: microsoft
                    emailAddress: workspace@example.com
                  deviceHostedMeetings:
                    enabled: true
                    siteUrl: '''example.webex.com'''
                  devicePlatform: cisco
                  indoorNavigation: {}
                  health:
                    level: error
                    issues:
                    - id: ''
                      createdAt: ''
                      title: ''
                      description: ''
                      recommendedAction: ''
                      level:
                        Members: error
                  devices:
                  - id: Y2lzY29zcGFyazovL3VybjpURUFNOnVzLWVhc3QtMV9pbnQxMy9ERVZJQ0UvNTEwMUIwN0ItNEY4Ri00RUY3LUI1NjUtREIxOUM3QjcyM0Y3
                    displayName: SFO12-3-PanHandle
                    placeId: Y2lzY29zcGFyazovL3VzL1BFT1BMRS83MTZlOWQxYy1jYTQ0LTRmZWQtOGZjYS05ZGY0YjRmNDE3ZjU
                    workspaceId: Y2lzY29zcGFyazovL3VzL1BFT1BMRS83MTZlOWQxYy1jYTQ0LTRmZWQtOGZjYS05ZGY0YjRmNDE3ZjU
                    personId: Y2lzY29zcGFyazovL3VzL1BFT1BMRS83MTZlOWQxYy1jYTQ0LTRmZWQtOGZjYS05ZGY0YjRmNDE3ZjU
                    orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE
                    capabilities:
                    - xapi
                    permissions:
                    - xapi:readonly
                    connectionStatus: connected
                    product: Cisco Webex DX80
                    type: roomdesk
                    tags:
                    - First Tag, Second Tag
                    ip: 100.110.120.130
                    activeInterface: wired
                    mac: 11:22:33:44:AA:FF
                    primarySipUrl: sample_device@sample_workspacename.orgname.org
                    sipUrls:
                    - sample_device@sample_workspacename.orgname.org, another_device@sample_workspacename.orgname.org
                    serial: FOC1923NVVN
                    software: RoomOS 2018-06-01 608dcdbb6e1
                    upgradeChannel: beta
                    created: '2016-04-21T17:00:00.000Z'
                    locationId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE
                    workspaceLocationId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE
                    errorCodes:
                    - sipprofileregistration
                    firstSeen: '2021-02-24T09:08:38.822Z'
                    lastSeen: '2023-08-15T14:04:00.444Z'
                    managedBy: CISCO
                    devicePlatform: cisco
                  capabilities:
                    occupancyDetection:
                      supported: true
                      configured: true
                    presenceDetection:
                      supported: true
                      configured: true
                    ambientNoise:
                      supported: true
                      configured: true
                    soundLevel:
                      supported: true
                      configured: true
                    temperature:
                      supported: true
                      configured: true
                    airQuality:
                      supported: true
                      configured: true
                    relativeHumidity:
                      supported: true
                      configured: true
                  plannedMaintenance:
                    mode: upcoming
                    startTime: '2026-10-01T00:00:00.000Z'
                    endTime: '2026-10-02T00:00:00.000Z'
                    description: Scheduled maintenance for the workspace.
                  customAttributes:
                    myKey:
                      value: '123456789'
                      type: external_id
        '400':
          description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.'
        '401':
          description: 'Unauthorized: Authentication credentials were missing or incorrect.'
        '403':
          description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.'
        '404':
          description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.'
        '405':
          description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.'
        '409':
          description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.'
        '410':
          description: 'Gone: The requested resource is no longer available.'
        '415':
          description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.'
        '423':
          description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.'
        '428':
          description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.'
        '429':
          description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.'
        '500':
          description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).'
        '502':
          description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.'
        '503':
          description: 'Service Unavailable: Server is overloaded with requests. Try again later.'
        '504':
          description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.'
      summary: List Workspaces
      operationId: listWorkspaces
      description: 'List workspaces.


        Use query parameters to filter the response. The `orgId` parameter can only be used by admin users of another organization (such as partners). The `locationId`, `workspaceLocationId`, `indoorNavigation`, `floorId`, `capacity` and `type` fields will only be present for workspaces that have a value set for them. The special values `notSet` (for filtering on category) and `-1` (for filtering on capacity) can be used to filter for workspaces without a type and/or capacity.'
      tags:
      - Workspaces
      parameters:
      - name: orgId
        in: query
        description: List workspaces in this organization. Only admin users of another organization (such as partners) may use this parameter.
        example: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE
        schema:
          type: string
      - name: locationId
        in: query
        description: Location associated with the workspace. Values must originate from the /locations API and not the legacy /workspaceLocations API.
        example: YL34GrT...
        schema:
          type: string
      - name: workspaceLocationId
        in: query
        description: Location associated with the workspace. Both values from the /locations API and the legacy /workspaceLocations API are supported. This field is deprecated and integrations should prefer `locationId` going forward.
        example: YL34GrT...
        schema:
          type: string
      - name: floorId
        in: query
        description: Floor associated with the workspace.
        example: Y2lzY29z...
        schema:
          type: string
      - name: displayName
        in: query
        description: List workspaces by display name.
        example: SFO-12 Capanina
        schema:
          type: string
      - name: capacity
        in: query
        description: List workspaces with the given capacity. Must be -1 or higher. A value of -1 lists workspaces with no capacity set.
        example: 5
        schema:
          type: number
      - name: type
        in: query
        description: List workspaces by type.
        example: focus
        schema:
          type: string
          enum:
          - notSet
          - focus
          - huddle
          - meetingRoom
          - open
          - desk
          - other
      - name: start
        in: query
        description: Offset. Default is 0.
        example: 50
        schema:
          type: number
      - name: max
        in: query
        description: Limit the maximum number of workspaces in the response.
        example: 100
        schema:
          type: number
      - name: calling
        in: query
        description: List workspaces by calling type.
        example: freeCalling
        schema:
          type: string
          enum:
          - freeCalling
          - hybridCalling
          - webexCalling
          - webexEdgeForDevices
          - thirdPartySipCalling
          - none
      - name: supportedDevices
        in: query
        description: List workspaces by supported devices.
        example: collaborationDevices
        schema:
          type: string
          enum:
          - collaborationDevices
          - phones
      - name: calendar
        in: query
        description: List workspaces by calendar type.
        example: none
        schema:
          type: string
          enum:
          - none
          - google
          - microsoft
      - name: deviceHostedMeetingsEnabled
        in: query
        description: List workspaces enabled for device hosted meetings.
        example: true
        schema:
          type: boolean
      - name: devicePlatform
        in: query
        description: List workspaces by device platform.
        example: cisco
        schema:
          type: string
          enum:
          - cisco
          - microsoftTeamsRoom
      - name: healthLevel
        in: query
        description: List workspaces by health level.
        example: error
        schema:
          type: string
          enum:
          - error
          - warning
          - info
          - ok
      - name: includeDevices
        in: query
        description: Flag identifying whether to include the devices associated with the workspace in the response.
        example: false
        schema:
          type: boolean
      - name: includeCapabilities
        in: query
        description: Flag identifying whether to include the workspace capabilities in the response.
        example: false
        schema:
          type: boolean
      - name: plannedMaintenance
        in: query
        description: List workspaces with given maintenance mode.
        example: 'off'
        schema:
          type: string
          enum:
          - 'off'
          - 'on'
          - upcoming
      - name: customAttribute
        in: query
        description: List workspaces with given custom attribute key.
        example: myKey
        schema:
          type: string
    post:
      responses:
        '201':
          description: Created
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              example:
                id: Y2lzY29zcGFyazovL3VzL1BMQUNFUy81MTAxQjA3Qi00RjhGLTRFRjctQjU2NS1EQjE5QzdCNzIzRjc
                orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8xZWI2NWZkZi05NjQzLTQxN2YtOTk3NC1hZDcyY2FlMGUxMGY
                locationId: YL34GrT...
                workspaceLocationId: YL34GrT...
                floorId: Y2lzY29z...
                displayName: SFO-12 Capanina
                capacity: 5
                sipAddress: test_workspace_1@trialorg.room.ciscospark.com
                created: '2016-04-21T17:00:00.000Z'
                calling:
                  type: webexCalling
                  webexCalling:
                    licenses:
                    - Y2lzY29zcGFyazovL3VzL0xJQ0VOU0UvMmQzMzIyZDItYTAzNS00YmEzLWI3ZjYtNDc1ODM3Y2UzOTVhOkJDQ0FfNDZlM2YxYWQtZGJhYi00YmQ0LTg3YTAtOWExZmVhNzMxN2Jm
                calendar:
                  type: microsoft
                  emailAddress: workspace@example.com
                notes: this is a note
                supportedDevices: collaborationDevices
                indoorNavigation:
                  url: https://example.com
        '400':
          description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.'
        '401':
          description: 'Unauthorized: Authentication credentials were missing or incorrect.'
        '403':
          description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.'
        '404':
          description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.'
        '405':
          description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.'
        '409':
          description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.'
        '410':
          description: 'Gone: The requested resource is no longer available.'
        '415':
          description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.'
        '423':
          description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.'
        '428':
          description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.'
        '429':
          description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.'
        '500':
          description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).'
        '502':
          description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.'
        '503':
          description: 'Service Unavailable: Server is overloaded with requests. Try again later.'
        '504':
          description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.'
      summary: Create a Workspace
      operationId: createWorkspace
      description: 'Create a workspace.


        The `locationId`, `workspaceLocationId`, `floorId`, `indoorNavigation`, `capacity`, `type`, `notes` and `hotdeskingStatus` parameters are optional, and omitting them will result in the creation of a workspace without these values set, or set to their default. A `locationId` must be provided when the `floorId` is set. Calendar and calling can also be set for a new workspace. Omitting them will default to free calling and no calendaring. The `orgId` parameter can only be used by admin users of another organization (such as partners).


        * Information for Webex Calling fields may be found here: [locations](/docs/api/v1/locations/list-locations), [available numbers](/docs/api/v1/numbers/get-phone-numbers-for-an-organization-with-given-criterias) and [licenses](/docs/api/v1/licenses).


        * The `locationId` and `supportedDevices` fields cannot be changed once configured.


        * When creating a `webexCalling` workspace that is not hot desk only, a `locationId` and either a `phoneNumber` or `extension` or both is required. Furthermore, it is possible to set the `licenses` field with a list of Webex Calling license IDs, if desired. If multiple license IDs are provided, the oldest suitable one will be applied. If no licenses are supplied, the oldest suitable one from the active subscriptions will be automaticaly applied.


        * When creating a hot desk only workspace, `phoneNumber` and `extension` fields are not applicable. Furthermore, `deviceHostedMeetingsEnabled`, and `calendar` services are not applicable. If any of these fields are provided the API will return an error. The `calling` type is `webexCalling`.'
      tags:
      - Workspaces
      parameters: []
      requestBody:
        content:
          application/json:
            example:
              displayName: SFO-12 Capanina
              orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8xZWI2NWZkZi05NjQzLTQxN2YtOTk3NC1hZDcyY2FlMGUxMGY
              locationId: YL34GrT...
              workspaceLocationId: YL34GrT...
              floorId: Y2lzY29z...
              capacity: 5
              type: notSet
              calling:
                type: webexCalling
                webexCalling:
                  phoneNumber: '+12145654032'
                  extension: '28278'
                  locationId: Y2lzY29g4...
                  licenses:
                  - Y2lzY29g4...1,Y2lzY29g4...2,Y2lzY29g4...n
              calendar:
                type: microsoft
                emailAddress: workspace@example.com
                resourceGroupId: Y2lzY29zcGFyazovL3VybjpURUFNOk5vcndheS9SRVNPVVJDRV9HUk9VUC9jOGFiMDJhNC01NjI5LTRiNTctOGUyNy03ZDZkZjJlN2YzNzA=
              notes: this is a note
              hotdeskingStatus: 'on'
              deviceHostedMeetings:
                enabled: true
                siteUrl: '''example.webex.com'''
              supportedDevices: collaborationDevices
              indoorNavigation: {}
            schema:
              $ref: '#/components/schemas/WorkspaceCreationRequest'
  /workspaces/{workspaceId}:
    get:
      responses:
        '200':
          description: OK
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              example:
                id: Y2lzY29zcGFyazovL3VzL1BMQUNFUy81MTAxQjA3Qi00RjhGLTRFRjctQjU2NS1EQjE5QzdCNzIzRjc
                orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8xZWI2NWZkZi05NjQzLTQxN2YtOTk3NC1hZDcyY2FlMGUxMGY
                locationId: Y2lzY29...
                workspaceLocationId: YL34GrT...
                floorId: Y2lzY29z...
                displayName: SFO-12 Capanina
                capacity: 5
                type: notSet
                sipAddress: test_workspace_1@trialorg.room.ciscospark.com
                created: '2016-04-21T17:00:00.000Z'
                calling:
                  type: hybridCalling
                  hybridCalling:
                    emailAddress: workspace@example.com
                  webexCalling:
                    licenses:
                    - Y2lzY29g4...
                notes: this is a note
                hotdeskingStatus: 'on'
                supportedDevices: collaborationDevices
                calendar:
                  type: microsoft
                  emailAddress: workspace@example.com
                deviceHostedMeetings:
                  enabled: true
                  siteUrl: '''example.webex.com'''
                devicePlatform: cisco
                indoorNavigation: {}
                health:
                  level: error
                  issues:
                  - id: ''
                    createdAt: ''
                    title: ''
                    description: ''
                    recommendedAction: ''
                    level:
                      Members: error
                devices:
                - id: Y2lzY29zcGFyazovL3VybjpURUFNOnVzLWVhc3QtMV9pbnQxMy9ERVZJQ0UvNTEwMUIwN0ItNEY4Ri00RUY3LUI1NjUtREIxOUM3QjcyM0Y3
                  displayName: SFO12-3-PanHandle
                  placeId: Y2lzY29zcGFyazovL3VzL1BFT1BMRS83MTZlOWQxYy1jYTQ0LTRmZWQtOGZjYS05ZGY0YjRmNDE3ZjU
                  workspaceId: Y2lzY29zcGFyazovL3VzL1BFT1BMRS83MTZlOWQxYy1jYTQ0LTRmZWQtOGZjYS05ZGY0YjRmNDE3ZjU
                  personId: Y2lzY29zcGFyazovL3VzL1BFT1BMRS83MTZlOWQxYy1jYTQ0LTRmZWQtOGZjYS05ZGY0YjRmNDE3ZjU
                  orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE
                  capabilities:
                  - xapi
                  permissions:
                  - xapi:readonly
                  connectionStatus: connected
                  product: Cisco Webex DX80
                  type: roomdesk
                  tags:
                  - First Tag, Second Tag
                  ip: 100.110.120.130
                  activeInterface: wired
                  mac: 11:22:33:44:AA:FF
                  primarySipUrl: sample_device@sample_workspacename.orgname.org
                  sipUrls:
                  - sample_device@sample_workspacename.orgname.org, another_device@sample_workspacename.orgname.org
                  serial: FOC1923NVVN
                  software: RoomOS 2018-06-01 608dcdbb6e1
                  upgradeChannel: beta
                  created: '2016-04-21T17:00:00.000Z'
                  locationId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE
                  workspaceLocationId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE
                  errorCodes:
                  - sipprofileregistration
                  firstSeen: '2021-02-24T09:08:38.822Z'
                  lastSeen: '2023-08-15T14:04:00.444Z'
                  managedBy: CISCO
                  devicePlatform: cisco
                capabilities:
                  occupancyDetection:
                    supported: true
                    configured: true
                  presenceDetection:
                    supported: true
                    configured: true
                  ambientNoise:
                    supported: true
                    configured: true
                  soundLevel:
                    supported: true
                    configured: true
                  temperature:
                    supported: true
                    configured: true
                  airQuality:
                    supported: true
                    configured: true
                  relativeHumidity:
                    supported: true
                    configured: true
        '400':
          description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.'
        '401':
          description: 'Unauthorized: Authentication credentials were missing or incorrect.'
        '403':
          description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.'
        '404':
          description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.'
        '405':
          description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.'
        '409':
          description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.'
        '410':
          description: 'Gone: The requested resource is no longer available.'
        '415':
          description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.'
        '423':
          description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.'
        '428':
          description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.'
        '429':
          description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.'
        '500':
          description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).'
        '502':
          description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.'
        '503':
          description: 'Service Unavailable: Server is overloaded with requests. Try again later.'
        '504':
          description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.'
      summary: Get Workspace Details
      operationId: getWorkspaceDetails
      description: 'Shows details for a workspace, by ID.


        The `locationId`, `workspaceLocationId`, `floorId`, `indoorNavigation`, `capacity`, `type` and `notes` fields will only be present if they have been set for the workspace. Specify the workspace ID in the `workspaceId` parameter in the URI.'
      tags:
      - Workspaces
      parameters:
      - name: workspaceId
        in: path
        description: A unique identifier for the workspace.
        required: true
        example: Y2lzY29zcGFyazovL3VzL1BMQUNFUy81MTAxQjA3Qi00RjhGLTRFRjctQjU2NS1EQjE5QzdCNzIzRjc
        schema:
          type: string
      - name: includeDevices
        in: query
        description: Flag identifying whether to include the devices associated with the workspace in the response.
        example: false
        schema:
          type: boolean
      - name: includeCapabilities
        in: query
        description: Flag identifying whether to include the workspace capabilities in the response.
        example: false
        schema:
          type: boolean
    put:
      responses:
        '200':
          description: OK
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              example:
                id: Y2lzY29zcGFyazovL3VzL1BMQUNFUy81MTAxQjA3Qi00RjhGLTRFRjctQjU2NS1EQjE5QzdCNzIzRjc
                orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8xZWI2NWZkZi05NjQzLTQxN2YtOTk3NC1hZDcyY2FlMGUxMGY
                locationId: YL34GrT...
                workspaceLocationId: YL34GrT...
                floorId: Y2lzY29z...
                displayName: SFO-12 Capanina
                capacity: 5
                sipAddress: test_workspace_1@trialorg.room.ciscospark.com
                created: '2016-04-21T17:00:00.000Z'
                calling:
                  type: webexCalling
                  webexCalling:
                    licenses:
                    - Y2lzY29z...
                calendar:
                  type: microsoft
                  emailAddress: workspace@example.com
                notes: this is a note
                supportedDevices: collaborationDevices
                devicePlatform: cisco
                indoorNavigation:
                  url: https://example.com
        '400':
          description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.'
        '401':
          description: 'Unauthorized: Authentication credentials were missing or incorrect.'
        '403':
          description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.'
        '404':
          description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.'
        '405':
          description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.'
        '409':
          description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.'
        '410':
          description: 'Gone: The requested resource is no longer available.'
        '415':
          description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.'
        '423':
          description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.'
        '428':
          description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.'
        '429':
          description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.'
        '500':
          description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).'
        '502':
          description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.'
        '503':
          description: 'Service Unavailable: Server is overloaded with requests. Try again later.'
        '504':
          description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.'
      summary: Update a Workspace
      operationId: updateWorkspace
      description: 'Updates details for a workspace by ID.


        Specify 

# --- truncated at 32 KB (72 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/webex/refs/heads/main/openapi/webex-workspaces-api-openapi.yml