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

> ## Agent Instructions
> These docs cover learner integrations through Hosted Lab Pages, the SDK, and the REST API. Content management is outside this integration scope.
> Read the setup page for the chosen approach before implementing it. Keep organization API keys and hosted mint secrets on the server.
> The public SDK is coming soon. Check the SDK quickstart for current availability. Do not invent installation commands or direct readers to a private package.
> Cybr provides completion tracking and CTF verification. The integrating platform decides whether to award points.

# Get deployment runs

> Returns build and teardown runs. An unknown deployment or one outside organization access returns an empty array. Run output can contain secrets. SDK: `deployments.getRuns()`.

SDK: `deployments.getRuns()`.


## OpenAPI

````yaml assets/openapi.json GET /api/v2/deployments/{deploymentId}/runs
openapi: 3.1.0
info:
  title: Cybr Labs public integration API
  version: 0.0.15
  description: SDK and REST integration contract. Organization keys remain on the server.
  contact:
    email: support@cybr.com
servers:
  - url: https://api.cybr.com
security:
  - OrganizationKey: []
tags:
  - name: Labs
    description: Content, progress, discussions, and resource links.
  - name: Deployments
    description: Lab environments and terminal sessions.
paths:
  /api/v2/deployments/{deploymentId}/runs:
    get:
      tags:
        - Deployments
      summary: Get deployment runs
      description: >-
        Returns build and teardown runs. An unknown deployment or one outside
        organization access returns an empty array. Run output can contain
        secrets. SDK: `deployments.getRuns()`.
      operationId: get_runs
      parameters:
        - name: deploymentId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DeploymentRun'
              example: []
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Access denied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Other API error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    DeploymentRun:
      type: object
      properties:
        id:
          type: string
        deploymentId:
          type: string
        action:
          enum:
            - apply
            - destroy
            - clean
        status:
          enum:
            - queued
            - running
            - completed
            - errored
        exitCode:
          anyOf:
            - type: integer
            - type: 'null'
        outputs:
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
        error:
          anyOf:
            - type: string
            - type: 'null'
        startedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        completedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - deploymentId
        - action
        - status
        - exitCode
        - outputs
        - error
        - startedAt
        - completedAt
        - createdAt
        - updatedAt
    Error:
      type: object
      properties:
        message:
          type: string
        retryAfter:
          type: number
        activeCount:
          type: integer
        limit:
          type: integer
        errors:
          type: array
          items:
            type: string
      required:
        - message
  securitySchemes:
    OrganizationKey:
      type: apiKey
      in: header
      name: X-API-Key

````