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

# List an execution's slots

> Returns every run the execution plans, with its run once started and its verdict once judged. Read a run's work with the runs endpoints.



## OpenAPI

````yaml https://tracks.alpic.ai/api/openapi.json get /executions/{id}/slots
openapi: 3.1.0
info:
  title: Tracks API
  version: 0.0.1
  description: >-
    Run coding agents such as Claude Code in isolated sandboxes with an API key
    of your organization. Create a run with a prompt, then follow its output and
    what it costs, or launch an experiment to compare agents on your scenarios.
servers:
  - url: https://tracks.alpic.ai/api
security: []
tags:
  - name: Runs
    description: Start coding agents and follow their work.
  - name: Files
    description: Upload files to place in a run's sandbox.
  - name: Connections
    description: >-
      Let agents use MCP servers as one of their users, without their
      credentials entering the sandbox.
  - name: Experiments
    description: >-
      Define scenarios to give several agents in several variants, judged on
      what they did.
  - name: Executions
    description: Launch experiments and read their results.
  - name: Library
    description: What your experiments can give their agents.
  - name: System
paths:
  /executions/{id}/slots:
    get:
      tags:
        - Executions
      summary: List an execution's slots
      description: >-
        Returns every run the execution plans, with its run once started and its
        verdict once judged. Read a run's work with the runs endpoints.
      operationId: executions.listSlots
      parameters:
        - name: id
          in: path
          schema:
            $ref: '#/components/schemas/ExecutionId'
          required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Slot'
                  has_more:
                    type: boolean
                    description: Whether more items are available after this page.
                required:
                  - data
                  - has_more
                additionalProperties: false
        '400':
          description: >-
            The request is invalid: a value is missing, has the wrong type or is
            out of range. Fix it before sending the request again.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidRequestEncoded'
        '401':
          description: >-
            The API key is missing, malformed or revoked, or its organization is
            closed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiKeyRefusedEncoded'
        '404':
          description: No execution with this id exists in your organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionNotFoundEncoded'
      security:
        - bearer: []
components:
  schemas:
    ExecutionId:
      type: string
      description: Unique identifier of the execution.
    Slot:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the slot.
        scenario_id:
          type: string
        repository_id:
          type: string
          description: Absent when the run has no repository.
        agent_tools_id:
          type: string
        agent:
          $ref: '#/components/schemas/ExperimentAgent'
        repetition:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
          description: Which of the identical runs it is, from 1.
        run_id:
          $ref: '#/components/schemas/RunId_1'
        outcome:
          type: string
          enum:
            - running
            - judging
            - judged
            - not_evaluated
          description: >-
            `running` while its run waits to start or has not ended, `judging`
            while it waits for evaluation results, `judged` once they are all
            in, or `not_evaluated` when it never will be.
        verdict:
          type: string
          enum:
            - passed
            - failed
          description: Whether the run passed its scenario, once judged.
        score:
          anyOf:
            - type: number
            - type: string
              enum:
                - Infinity
                - '-Infinity'
                - NaN
        not_evaluated_reason:
          type: string
          enum:
            - never_started
            - no_evaluations
            - run_not_completed
            - agent_failed
            - evidence_too_long
            - too_many_attempts
          description: >-
            Why the run has no verdict: it never started, its scenario has no
            evaluations, it did not end `completed`, its agent stopped with an
            error such as its model provider being unreachable, what it did was
            too long to judge, or judging failed too many times.
        refusal:
          type: string
          description: Why its run could not start.
        evaluation_results:
          type: array
          items:
            type: object
            properties:
              evaluation_id:
                type: string
              passed:
                type: boolean
            required:
              - evaluation_id
              - passed
            additionalProperties: false
          description: Each evaluation judged so far, and whether the run passed it.
      required:
        - id
        - scenario_id
        - agent_tools_id
        - agent
        - repetition
        - outcome
        - evaluation_results
      additionalProperties: false
      description: >-
        One run an execution plans, for one scenario, variant, agent and
        repetition, and how it was judged.
    InvalidRequestEncoded:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - InvalidRequest
        message:
          type: string
          description: Every problem found, in one sentence.
        location:
          type: string
          enum:
            - path
            - query
            - header
            - body
          description: The part of the request that is wrong.
        issues:
          type: array
          items:
            $ref: '#/components/schemas/RequestIssue'
          description: Each problem found, with where it is.
      required:
        - _tag
        - message
        - location
        - issues
      additionalProperties: false
    ApiKeyRefusedEncoded:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - ApiKeyRefused
        message:
          type: string
      required:
        - _tag
        - message
      additionalProperties: false
    ExecutionNotFoundEncoded:
      type: object
      properties:
        _tag:
          type: string
          enum:
            - ExecutionNotFound
        message:
          type: string
      required:
        - _tag
        - message
      additionalProperties: false
    ExperimentAgent:
      type: object
      properties:
        harness:
          $ref: '#/components/schemas/Harness'
        model:
          type: string
          description: Model the agent uses, such as `claude-sonnet-5-5`.
      required:
        - harness
        - model
      additionalProperties: false
      description: A coding agent and the model it uses.
    RunId_1:
      type: string
      description: The run, once started.
    RequestIssue:
      type: object
      properties:
        path:
          type: array
          items:
            anyOf:
              - type: string
              - type: number
              - type: string
                enum:
                  - Infinity
                  - '-Infinity'
                  - NaN
          description: >-
            Keys leading to the wrong value inside that part of the request,
            such as `["agent", "model"]`. Empty when the problem concerns that
            part as a whole.
        message:
          type: string
          description: What is wrong with the value.
      required:
        - path
        - message
      additionalProperties: false
      description: One problem found in the request.
    Harness:
      type: string
      enum:
        - claude-code
        - claude-desktop
        - codex
        - codex-app
        - cursor
      description: >-
        The coding agent to run: `claude-code` (Claude Code), `claude-desktop`
        (Cowork, the agent workspace of Anthropic's Claude desktop app, for
        documents, research and longer tasks), `codex` (OpenAI's Codex CLI),
        `codex-app` (the Codex mode of OpenAI's ChatGPT desktop app, with its
        browser, computer-use and document tools) or `cursor` (Cursor's CLI).
  securitySchemes:
    bearer:
      description: >-
        An API key of your organization, starting with `trk_`, sent as
        `Authorization: Bearer <key>`.
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.