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

# Get the status of a DAG-failure diagnosis run

> Returns the current status of a DAG-failure diagnosis run.



## OpenAPI

````yaml /astro/api/v-1-labs/openapi.yaml get /organizations/{organizationId}/observability/deployments/{deploymentId}/dag-failure-diagnosis/runs/{diagnosisRunId}/status
openapi: 3.0.3
info:
  contact: {}
  description: Astro Labs API - Experimental endpoints for preview features
  title: Astro Labs API
  version: v1
servers:
  - url: https://api.astronomer.io/labs/v1
security:
  - JWT: []
tags:
  - description: >-
      Canned-data placeholder used to exercise the labs epoch versioning
      surface. Real labs endpoints register their own tags.
    name: Example
paths:
  /organizations/{organizationId}/observability/deployments/{deploymentId}/dag-failure-diagnosis/runs/{diagnosisRunId}/status:
    get:
      tags:
        - Observability
      summary: Get the status of a DAG-failure diagnosis run
      description: Returns the current status of a DAG-failure diagnosis run.
      operationId: LabsGetDagFailureDiagnosisStatus
      parameters:
        - description: The ID of the Organization to which the Deployment belongs.
          in: path
          name: organizationId
          required: true
          schema:
            type: string
        - description: The Deployment's ID.
          in: path
          name: deploymentId
          required: true
          schema:
            type: string
        - description: The diagnosis run ID.
          in: path
          name: diagnosisRunId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DagFailureDiagnosisRunStatus'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Internal Server Error
      security:
        - JWT: []
components:
  schemas:
    DagFailureDiagnosisRunStatus:
      properties:
        createdAt:
          description: The RFC3339 timestamp when the run was created.
          example: '2026-05-14T12:34:56Z'
          type: string
        runId:
          description: The unique identifier of the diagnosis run.
          example: 7f3b6f5d-2c4e-4f2b-9c1d-1a2b3c4d5e6f
          type: string
        status:
          description: The current status of the diagnosis run.
          enum:
            - pending
            - running
            - completed
            - failed
            - timed_out
          example: running
          type: string
        updatedAt:
          description: The RFC3339 timestamp when the run was last updated.
          example: '2026-05-14T12:35:10Z'
          type: string
      required:
        - createdAt
        - runId
        - status
        - updatedAt
      type: object
    Error:
      properties:
        fieldErrors:
          description: >-
            FieldErrors carries one entry per failed request-validation
            constraint.

            Only present on 400 responses caused by request binding/validation.
          items:
            $ref: '#/components/schemas/FieldValidationError'
          type: array
        message:
          type: string
        requestId:
          type: string
        statusCode:
          maximum: 600
          minimum: 400
          type: integer
      required:
        - message
        - requestId
        - statusCode
      type: object
    FieldValidationError:
      properties:
        code:
          type: string
        field:
          type: string
        message:
          type: string
      required:
        - code
        - field
        - message
      type: object
  securitySchemes:
    JWT:
      scheme: bearer
      type: http

````