> ## 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. # List disks > Returns a paginated list of Workspace disks for the selected Workspace. ## OpenAPI ````yaml /en/api-reference/openapi.en-v1.json get /v1/organizations/{organization_id}/workspaces/{workspace_id}/disks openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: Public REST API for portal servers: - url: https://api.flexxible.net/ description: Portal API security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/workspaces/{workspace_id}/disks: get: tags: - Workspaces summary: List disks description: Returns a paginated list of Workspace disks for the selected Workspace. operationId: workspaces_disks parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Organization identifier. example: 507f1f77bcf86cd799439011 - name: workspace_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: 'Workspace ID ' example: 507f1f77bcf86cd799439099 - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: Page number. - name: per_page in: query required: false schema: type: integer default: 100 maximum: 100 minimum: 1 description: Number of items per page. - name: fields in: query required: false schema: type: string maxLength: 2048 description: Comma-separated names of response item fields to include. - name: filters in: query required: false schema: type: string maxLength: 5120 description: JSON filter expression on filterable field paths of the response. examples: simple: summary: Filter by disk name value: '{"field":"name","op":"contains","value":"system"}' complex-and: summary: Filter by media type and encryption status value: >- {"and":[{"field":"media_type","op":"eq","value":"SSD"},{"field":"encrypted","op":"eq","value":"encrypted"}]} complex-or-and: summary: Combine location alternatives with OS unit condition value: >- {"and":[{"or":[{"field":"location","op":"contains","value":"C:"},{"field":"location","op":"contains","value":"D:"}]},{"field":"os_drive","op":"eq","value":true}]} - name: sort in: query required: false schema: type: string description: >- Sort expression in the format :asc|desc over sortable scalar field paths of the response. responses: '200': description: Workspace disks retrieved successfully. content: application/json: schema: $ref: '#/components/schemas/GetWorkspaceDisksResponseV1' examples: paginated_result: summary: Paginated list with disk records value: has_next: false data: - id: cd607b6eb7d74f3990e62f0f name: 'D:' device_id: \\.\PHYSICALDRIVE1 encrypted: not_encrypted encryption_method: None location: >- Integrated : Bus 0 : Device 14 : Function 0 : Adapter 0 : Port 3 : Target 2 : LUN 0 media_type: NTFS os_drive: false partition: 'Disk #1, Partition #0' physical_disk_size: 953869 total_size: 953866 used_size: 953333 volume_label: Data empty_result: summary: No disks found value: has_next: false data: [] '400': description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Invalid filters format value: error: message: Formato de filters no valido code: bad_request details: filters debe ser una cadena JSON valida '401': description: Not authorized or organization not accessible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Organization access failure value: error: message: No autorizado code: unauthorized '404': description: Workspace not found within the organization's authorized scope. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: workspace_not_found: summary: The Workspace does not exist within the scope value: error: message: Workspace no encontrado code: not_found '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Unhandled failure value: error: message: Error interno del servidor code: internal_error components: schemas: GetWorkspaceDisksResponseV1: type: object properties: has_next: type: boolean description: If another page is available. data: type: array items: $ref: '#/components/schemas/GetWorkspaceDiskItemV1' required: - has_next - data ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error GetWorkspaceDiskItemV1: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Disk record identifier. name: type: string description: Disk name. device_id: type: string description: Disk device identifier string. encrypted: type: string enum: - not_encrypted - encrypted - partially_encrypted - na description: Disk encryption status. encryption_method: type: string description: Encryption method label. location: type: string description: Disk location label. media_type: type: string description: Disk media type. os_drive: type: boolean nullable: true description: If the disk is marked as OS drive. partition: type: string description: Partition descriptor. physical_disk_size: type: number description: Physical disk size value. total_size: type: number description: Total disk size value. last_updated_at: type: string description: Date of last update to the disk record. used_size: type: number description: Used disk size value. volume_label: type: string description: Volume label. required: - id - name - device_id - encrypted - encryption_method - location - partition - physical_disk_size - total_size securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````