> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blaxel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workspace Schedule Executions

> Returns schedule execution submissions across the workspace, newest first by default. Status describes submission acceptance, not process completion. since and until are inclusive RFC 3339 bounds on creation time.



## OpenAPI

````yaml /api-reference/controlplane.yml get /schedule-executions
openapi: 3.0.3
info:
  title: Blaxel Control Plane
  version: 0.0.1
servers:
  - description: Blaxel Control Plane
    url: https://api.blaxel.ai/v0
  - description: Blaxel Inference
    url: https://run.blaxel.ai
security:
  - OAuth2:
      - admin
  - ApiKeyAuth: []
paths:
  /schedule-executions:
    get:
      tags:
        - compute
      summary: List Workspace Schedule Executions
      description: >-
        Returns schedule execution submissions across the workspace, newest
        first by default. Status describes submission acceptance, not process
        completion. since and until are inclusive RFC 3339 bounds on creation
        time.
      operationId: ListScheduleExecutions
      parameters:
        - description: Number of items per page
          in: query
          name: limit
          required: false
          schema:
            default: 20
            maximum: 100
            minimum: 1
            type: integer
        - $ref: '#/components/parameters/PaginationCursor'
        - description: Sort by creation time. Defaults to newest first.
          in: query
          name: sort
          required: false
          schema:
            enum:
              - createdAt:desc
              - createdAt:asc
            type: string
        - $ref: '#/components/parameters/PaginationQuery'
        - description: >-
            Filter by process submission acceptance status. Historical rows
            without status do not match this filter.
          in: query
          name: status
          required: false
          schema:
            enum:
              - succeeded
              - failed
            type: string
        - description: Filter by sandbox name.
          in: query
          name: sandbox
          required: false
          schema:
            type: string
        - description: Filter by schedule id.
          in: query
          name: schedule
          required: false
          schema:
            type: string
        - description: Inclusive beginning of the createdAt window, as RFC 3339.
          in: query
          name: since
          required: false
          schema:
            format: date-time
            type: string
        - description: Inclusive end of the createdAt window, as RFC 3339.
          in: query
          name: until
          required: false
          schema:
            format: date-time
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SandboxScheduleExecutionList'
          description: successful operation
      security:
        - OAuth2:
            - sandboxes:get
        - ApiKeyAuth: []
components:
  parameters:
    PaginationCursor:
      description: >-
        Opaque cursor returned by a previous response's meta.nextCursor. Only
        valid for the same query (workspace + filters); the server rejects
        cursors bound to a different query or older than 24h. Omit on the first
        page.
      in: query
      name: cursor
      required: false
      schema:
        type: string
      x-stainless-pagination-property:
        purpose: next_cursor_param
    PaginationQuery:
      description: >-
        Substring search across `metadata.name`, `metadata.displayName` and
        labels (keys + values). Trimmed and lowercased server-side; queries
        shorter than 2 characters fall back to the unfiltered listing. Bound
        into the cursor fingerprint so a cursor opened with one query cannot be
        reused with another. Only honoured starting on Blaxel-Version
        2026-04-28.
      in: query
      name: q
      required: false
      schema:
        maxLength: 200
        type: string
  schemas:
    SandboxScheduleExecutionList:
      type: object
      description: >-
        Cursor-paginated list of a sandbox's schedule execution history (across
        all its schedules).
      properties:
        data:
          type: array
          description: Page of schedule executions.
          items:
            $ref: '#/components/schemas/SandboxScheduleExecution'
        meta:
          $ref: '#/components/schemas/PaginationMeta'
    SandboxScheduleExecution:
      type: object
      description: >-
        One recorded execution of a sandbox schedule. status and statusCode
        describe whether the scheduler's process submission was accepted; the
        scheduler does not wait for the process to finish. Stored in the
        dedicated scheduleexecutions table.
      properties:
        createdAt:
          type: string
          description: Creation timestamp (read-only).
          readOnly: true
        error:
          type: string
          description: >-
            Reason the execution failed, naming the resource that could not be
            reached. Empty when the command was accepted by the sandbox.
          example: >-
            sandbox my-sandbox is not reachable at https://xxx.us-pdx-1.bl.run
            (HTTP 404)
        executedAt:
          type: string
          description: RFC 3339 time at which the command was submitted.
          example: '2026-07-01T09:00:00Z'
        id:
          type: string
          description: Unique id of this execution within the schedule.
          example: '00000000000000000042'
        processName:
          type: string
          description: >-
            Name of the process started in the sandbox for this execution, used
            to look up its logs.
          example: training-job
        sandbox:
          type: string
          description: Name of the sandbox this execution belongs to.
          readOnly: true
        scheduleId:
          type: string
          description: Id of the schedule this execution belongs to.
          example: schedule-0
        status:
          type: string
          description: >-
            Whether submitting the process request was accepted. This is not the
            process completion status.
          enum:
            - succeeded
            - failed
          readOnly: true
        statusCode:
          type: integer
          description: >-
            HTTP status code returned when the scheduled command was submitted
            to the sandbox (0 if the sandbox could not be reached). 2xx/3xx
            means the command was accepted.
          example: 200
        timeout:
          type: integer
          description: >-
            Process timeout in seconds for this execution. The UI uses it to
            scope the log view to [executedAt, executedAt+timeout]. 0 when the
            schedule set no timeout.
          example: 600
    PaginationMeta:
      type: object
      description: >-
        Pagination metadata returned alongside a page of listing results. Always
        present on listing endpoints starting with API version 2026-04-28.
      properties:
        hasMore:
          type: boolean
          description: True when more pages are available beyond the current one.
        nextCursor:
          type: string
          description: >-
            Opaque cursor to pass back as the `cursor` query param for the next
            page. Empty when there are no more pages.
        total:
          type: integer
          description: >-
            Total number of items in the workspace, ignoring the current page's
            filters. Lets the UI render "page X of Y" without walking the cursor
            chain. Computed from the hash-only metadata.workspace GSI count, so
            search (`q`) does not narrow it.
  securitySchemes:
    OAuth2:
      description: OAuth2 authentication with JWT tokens
      flows:
        authorizationCode:
          authorizationUrl: /oauth/authorize
          scopes:
            admin: Administrative access
            agents:create: Create agents
            agents:delete: Delete agents
            agents:get: Get agent details
            agents:list: List agents
            agents:update: Update agents
            apiKey:list: List API keys
            apiKey:write: Create and delete API keys
            applications:create: Create applications
            applications:delete: Delete applications
            applications:get: Get application details
            applications:list: List applications
            applications:update: Update applications
            configurations:list: List configurations
            customdomains:create: Create custom domains
            customdomains:delete: Delete custom domains
            customdomains:get: Get custom domain details
            customdomains:list: List custom domains
            customdomains:update: Update custom domains
            functions:create: Create functions
            functions:delete: Delete functions
            functions:get: Get function details
            functions:list: List functions
            functions:update: Update functions
            integrations:create: Create integrations
            integrations:list: List integrations
            invitations:list: List invitations
            jobs:create: Create jobs
            jobs:delete: Delete jobs
            jobs:get: Get job details
            jobs:list: List jobs
            jobs:update: Update jobs
            locations:list: List locations
            mcphub:list: List MCP hub resources
            models:create: Create models
            models:delete: Delete models
            models:get: Get model details
            models:list: List models
            models:update: Update models
            policies:create: Create policies
            policies:delete: Delete policies
            policies:get: Get policy details
            policies:list: List policies
            policies:update: Update policies
            sandboxes:control: Control sandbox operations
            sandboxes:create: Create sandboxes
            sandboxes:delete: Delete sandboxes
            sandboxes:get: Get sandbox details
            sandboxes:list: List sandboxes
            sandboxes:update: Update sandboxes
            sandboxhub:list: List sandbox hub resources
            templates:get: Get template details
            templates:list: List templates
            volumeTemplates:create: Create volume templates
            volumeTemplates:delete: Delete volume templates
            volumeTemplates:get: Get volume template details
            volumeTemplates:list: List volume templates
            volumeTemplates:upsert: Create or update volume templates
            volumes:create: Create volumes
            volumes:delete: Delete volumes
            volumes:get: Get volume details
            volumes:list: List volumes
            workspaces:accept: Accept workspace invitation
            workspaces:create: Create workspaces
            workspaces:decline: Decline workspace invitation
            workspaces:delete: Delete workspaces
            workspaces:get: Get workspace details
            workspaces:invite: Invite users to workspace
            workspaces:leave: Leave workspace
            workspaces:list: List workspaces
            workspaces:remove: Remove users from workspace
            workspaces:update: Update workspaces
          tokenUrl: /oauth/token
        clientCredentials:
          scopes:
            admin: Administrative access
            agents:create: Create agents
            agents:delete: Delete agents
            agents:get: Get agent details
            agents:list: List agents
            agents:update: Update agents
            apiKey:list: List API keys
            apiKey:write: Create and delete API keys
            applications:create: Create applications
            applications:delete: Delete applications
            applications:get: Get application details
            applications:list: List applications
            applications:update: Update applications
            configurations:list: List configurations
            customdomains:create: Create custom domains
            customdomains:delete: Delete custom domains
            customdomains:get: Get custom domain details
            customdomains:list: List custom domains
            customdomains:update: Update custom domains
            functions:create: Create functions
            functions:delete: Delete functions
            functions:get: Get function details
            functions:list: List functions
            functions:update: Update functions
            integrations:create: Create integrations
            integrations:list: List integrations
            invitations:list: List invitations
            jobs:create: Create jobs
            jobs:delete: Delete jobs
            jobs:get: Get job details
            jobs:list: List jobs
            jobs:update: Update jobs
            locations:list: List locations
            mcphub:list: List MCP hub resources
            models:create: Create models
            models:delete: Delete models
            models:get: Get model details
            models:list: List models
            models:update: Update models
            policies:create: Create policies
            policies:delete: Delete policies
            policies:get: Get policy details
            policies:list: List policies
            policies:update: Update policies
            sandboxes:control: Control sandbox operations
            sandboxes:create: Create sandboxes
            sandboxes:delete: Delete sandboxes
            sandboxes:get: Get sandbox details
            sandboxes:list: List sandboxes
            sandboxes:update: Update sandboxes
            sandboxhub:list: List sandbox hub resources
            templates:get: Get template details
            templates:list: List templates
            volumeTemplates:create: Create volume templates
            volumeTemplates:delete: Delete volume templates
            volumeTemplates:get: Get volume template details
            volumeTemplates:list: List volume templates
            volumeTemplates:upsert: Create or update volume templates
            volumes:create: Create volumes
            volumes:delete: Delete volumes
            volumes:get: Get volume details
            volumes:list: List volumes
            workspaces:accept: Accept workspace invitation
            workspaces:create: Create workspaces
            workspaces:decline: Decline workspace invitation
            workspaces:delete: Delete workspaces
            workspaces:get: Get workspace details
            workspaces:invite: Invite users to workspace
            workspaces:leave: Leave workspace
            workspaces:list: List workspaces
            workspaces:remove: Remove users from workspace
            workspaces:update: Update workspaces
          tokenUrl: /oauth/token
      type: oauth2
    ApiKeyAuth:
      bearerFormat: API Key
      description: Long-lived API key for programmatic access
      scheme: bearer
      type: http

````