> ## 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 Sandbox Schedule Executions

> Returns the execution history of a Sandbox's schedules (across all schedules of the sandbox), newest first. Cursor-paginated via the `cursor` and `limit` query parameters. Each item records the HTTP status of submitting the scheduled command and the process name for log lookup.



## OpenAPI

````yaml /api-reference/controlplane.yml get /sandboxes/{sandboxName}/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:
  /sandboxes/{sandboxName}/schedule-executions:
    parameters:
      - description: Name of the Sandbox
        in: path
        name: sandboxName
        required: true
        schema:
          type: string
    get:
      tags:
        - compute
      summary: List Sandbox Schedule Executions
      description: >-
        Returns the execution history of a Sandbox's schedules (across all
        schedules of the sandbox), newest first. Cursor-paginated via the
        `cursor` and `limit` query parameters. Each item records the HTTP status
        of submitting the scheduled command and the process name for log lookup.
      operationId: ListSandboxScheduleExecutions
      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'
        - $ref: '#/components/parameters/PaginationSort'
        - $ref: '#/components/parameters/PaginationQuery'
      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
    PaginationSort:
      description: >-
        Sort spec, formatted as `<key>:<direction>`. Allowed values are
        `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`.
        The cursor fingerprint is bound to the sort, so a cursor opened with one
        value cannot be reused with another. Only honoured starting on
        Blaxel-Version 2026-04-28.
      in: query
      name: sort
      required: false
      schema:
        enum:
          - createdAt:desc
          - createdAt:asc
          - name:asc
          - name:desc
        type: string
    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. statusCode is the HTTP
        status from submitting the command to the sandbox (the scheduler does
        not wait for the command to finish). Stored in the dedicated
        scheduleexecutions table.
      properties:
        createdAt:
          type: string
          description: Creation timestamp (read-only).
          readOnly: true
        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
        scheduleId:
          type: string
          description: Id of the schedule this execution belongs to.
          example: schedule-0
        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

````