> ## Documentation Index
> Fetch the complete documentation index at: https://cerebrium-docs-deepgram-260728.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Run

> Retrieve details for a specific run of an app.



## OpenAPI

````yaml https://s3.eu-west-1.amazonaws.com/www.cerebrium.ai/openapi_spec.json get /v2/projects/{project_id}/apps/{app_id}/runs/{run_id}
openapi: 3.0.0
info:
  title: Cerebrium REST API
  description: >-
    REST API for interacting with Cerebrium. This API is mainly used by the
    Cerebrium CLI client, please run `pip install cerebrium` to install it.
  version: 1.0.0
  license:
    name: Proprietary
    url: https://www.cerebrium.ai/terms-of-service
servers:
  - url: https://rest.cerebrium.ai
security: []
paths:
  /v2/projects/{project_id}/apps/{app_id}/runs/{run_id}:
    get:
      tags:
        - Runs
      summary: Get Run
      description: Retrieve details for a specific run of an app.
      operationId: getAppRun
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
        - name: app_id
          in: path
          required: true
          schema:
            type: string
        - name: run_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Details of the requested run.
          content:
            application/json:
              schema:
                properties:
                  item:
                    description: >-
                      The run. Includes id, modelId, projectId, status,
                      statusCode (integer), async (boolean), websocket
                      (boolean), createdAt, updatedAt, completedAt, containerId,
                      containerStartedAt, functionName, method, region, queue
                      and response timing fields in milliseconds (queueTimeMs,
                      runtimeMs, responseTimeMs, activatorQueueTimeMs,
                      containerQueueTimeMs, totalQueueTimeMs, executionTimeMs,
                      totalResponseTimeMs), request metadata (ip, accept,
                      contentLength, origin, referrer, userAgent,
                      websocketStream, webhookEndpoint), and for ephemeral runs
                      the run configuration (ephemeral, command, hardware, cpu,
                      memory, gpuCount, createdByUserId).
                    type: object
                type: object
        '400':
          description: >-
            Bad request. The request was malformed or contained invalid
            parameters.
          content:
            application/json:
              schema:
                properties:
                  message:
                    description: Human-readable description of the error.
                    type: string
                type: object
        '401':
          description: >-
            Unauthorized. The Authorization header is missing or the token is
            invalid.
          content:
            application/json:
              schema:
                properties:
                  message:
                    description: Human-readable description of the error.
                    type: string
                type: object
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Service Account Token authentication. To authenticate API requests:


        1. **Create a Service Account Token:**
           - Go to the [Cerebrium Dashboard](https://dashboard.cerebrium.ai/) and open the **API Keys** page
           - Click **Create Service Account**, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click **Create**
           - **Copy the token** generated for the desired service account

        2. **Use the Token:**
           Include the service account token in the Authorization header of API requests:
           `Authorization: Bearer <your-service-account-token>`

        3. **Best Practices:**
           - Create separate service accounts for different environments (dev, staging, prod)
           - Store tokens securely as secrets in consuming applications or workflows
           - Set appropriate expiry dates and rotate tokens regularly
           - Never commit tokens to source control

        For CI/CD integration examples, see the [CI/CD
        documentation](https://docs.cerebrium.ai/cerebrium/deployments/ci-cd).

````