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

# List cron schedules

> Retrieve all configured cron schedules for a group of workspaces. Returns an array of schedule objects containing cron expression, timezone, type, intermediate device information, and audit metadata. If the workspace group has no schedules, an empty array is returned.



## OpenAPI

````yaml /en/api-reference/openapi.en-v1.json get /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules
openapi: 3.0.3
info:
  title: Public Portal API
  version: 1.0.0
  description: Public REST API for portal
servers:
  - url: https://api.staging.flxwvdexternal.com
    description: Staging API server.
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules:
    get:
      tags:
        - Workspace groups
      summary: List cron schedules
      description: >-
        Retrieve all configured cron schedules for a group of workspaces.
        Returns an array of schedule objects containing cron expression,
        timezone, type, intermediate device information, and audit metadata. If
        the workspace group has no schedules, an empty array is returned.
      operationId: listWorkspaceGroupSchedules
      parameters:
        - name: organization id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: The unique identifier of the organization
          example: 507f1f77bcf86cd799439011
        - name: workspace_group_id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: The unique identifier of the workspace group
          example: 507f1f77bcf86cd799439020
      responses:
        '200':
          description: >-
            Schedule list successfully retrieved. Returns an array of schedule
            objects. Empty array if no schedules exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceGroupScheduleV1ListResponseV1'
        '400':
          $ref: '#/components/responses/BadRequest'
          description: 'Invalid request: Invalid workspace group ID format'
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: >-
            Unauthorized: user does not have access to the organization or the
            organization does not exist
        '404':
          $ref: '#/components/responses/NotFound'
          description: >-
            Workspace group not found or workspace group belongs to a different
            organization (after authorization is checked)
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    WorkspaceGroupScheduleV1ListResponseV1:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/WorkspaceGroupScheduleV1'
          description: Array of cron schedules for the workspace group
      required:
        - data
    WorkspaceGroupScheduleV1:
      type: object
      required:
        - id
        - cron_expression
        - time_zone
        - type
      properties:
        id:
          type: string
          pattern: ^[0-9a-f]{24}$
          description: The unique identifier of the schedule
          example: 507f1f77bcf86cd799439060
        cron_expression:
          type: string
          description: >-
            Cron expression defining when the schedule runs. Format: minute hour
            day-of-month month day-of-week.
          example: 0 8 * * 1-5
        time_zone:
          type: string
          description: >-
            Timezone for the execution of the schedule. Supports IANA
            identifiers (e.g., 'America/New_York') and Windows identifiers
            (e.g., 'Pacific Standard Time').
          example: Eastern Standard Time
        type:
          type: string
          enum:
            - start
            - stop
            - restart
          description: >-
            Power operation type: START (switch on), STOP (switch off), RESTART
            (restart Workspaces)
        intermediate_device:
          type: string
          pattern: ^[0-9a-f]{24}$
          nullable: true
          description: >-
            The unique identifier of the intermediate device Workspace, if
            configured. Used for Wake on LAN actions in secure networks.
          example: 507f1f77bcf86cd799439050
        created_by:
          type: string
          pattern: ^[0-9a-f]{24}$
          nullable: true
          description: User ID who created the schedule
          example: 507f1f77bcf86cd799439070
    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: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Too Many Requests
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````