---
updatedAt: 2026-05-28T13:22:33.000Z
agentTools:
  projectIndex: https://api.help.mabl.com/llms.txt
---

# Query Deployment Events

Used to query deployment events

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "mabl API",
    "description": "APIs for interacting with mabl services",
    "version": "0.563.3-2026-10-09.1791576280-jbaldassari-1791576682-SNAPSHOT"
  },
  "servers": [
    {
      "url": "https://api.mabl.com/"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      },
      "bearerAuth": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "ExternalTestCase": {
        "description": "External test case",
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Id associated with this test case"
          }
        }
      },
      "BaseTestRunResult": {
        "description": "Results of a test run",
        "type": "object",
        "properties": {
          "failure_summary": {
            "$ref": "#/components/schemas/TestRunFailureSummary",
            "description": "Contains supplemental information about test execution failure"
          },
          "started_time": {
            "type": "integer",
            "format": "int64",
            "description": "Time test run was started, in epoch milliseconds"
          },
          "test_cases": {
            "type": "array",
            "readOnly": true,
            "description": "User provided external test cases",
            "items": {
              "$ref": "#/components/schemas/ExternalTestCase"
            }
          },
          "status_cause": {
            "type": "string",
            "description": "Cause for setting given status, such as failure cause. Updated in pairs with Status."
          },
          "test_ref_id": {
            "type": "string",
            "description": "reference to this test in another system"
          },
          "test_labels": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Test labels"
          },
          "test_type": {
            "$ref": "#/components/schemas/TestTypeEnum"
          },
          "workspace_id": {
            "type": "string",
            "description": "workspace Id"
          },
          "execution_source": {
            "$ref": "#/components/schemas/TestSource"
          },
          "completed_time": {
            "type": "integer",
            "format": "int64",
            "description": "Time test run was completed, in epoch milliseconds"
          },
          "id": {
            "type": "string",
            "description": "Test run id"
          },
          "journey_id": {
            "type": "string",
            "description": "(deprecated, use test_id) Test id",
            "readOnly": true
          },
          "test_name": {
            "type": "string",
            "description": "Test name"
          },
          "outcome": {
            "type": "string",
            "description": "The final outcome of this test run",
            "$ref": "#/components/schemas/TestRunResultOutcomeEnum"
          },
          "test_id": {
            "type": "string",
            "description": "Test id",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "description": "The current status of this test run",
            "enum": [
              "awaiting_precondition",
              "skipped",
              "rate_limited",
              "queued",
              "running",
              "completed",
              "failed",
              "terminating",
              "terminated"
            ]
          }
        }
      },
      "DeploymentEventResult": {
        "description": "Describes a deployment event and the result of any triggered plan runs",
        "type": "object",
        "required": [
          "id",
          "workspace_id"
        ],
        "properties": {
          "plan_overrides": {
            "type": "object",
            "description": "Optional overrides specified for the stored properties of any triggered plans"
          },
          "environment_id": {
            "type": "string",
            "description": "ID of the environment associated with this deployment"
          },
          "test_selection": {
            "$ref": "#/components/schemas/TestSelection"
          },
          "received_time": {
            "type": "integer",
            "format": "int64",
            "description": "Epoch millisecond timestamp the event was received at"
          },
          "run_result": {
            "readOnly": true,
            "$ref": "#/components/schemas/ExecutionResult"
          },
          "triggered_plan_run_summaries": {
            "type": "array",
            "description": "Summary of the plans that were triggered by this deployment event",
            "items": {
              "$ref": "#/components/schemas/DeploymentPlanSummary"
            }
          },
          "plan_labels": {
            "type": "array",
            "description": "If specified, only plans matching the given labels were executed",
            "items": {
              "type": "string"
            }
          },
          "application_id": {
            "type": "string",
            "description": "ID of the application associated with this deployment"
          },
          "branch": {
            "type": "string",
            "description": "The mabl branch the event named, from branch or source_control_tag, even when mabl has no such branch. Absent when the event named none. The branch each selected test ran on is in test_selection.resolved_tests"
          },
          "revision": {
            "type": "string",
            "description": "Source code revision"
          },
          "workspace_id": {
            "type": "string",
            "description": "ID of the workspace associated with this deployment"
          },
          "application_name": {
            "type": "string",
            "description": "Name of the application associated with this deployment. Absent when the deployment carries no application or the application has since been deleted."
          },
          "id": {
            "type": "string",
            "description": "Unique ID for the deployment event"
          },
          "actions": {
            "type": "object",
            "description": "Optional actions specified for mabl to take on this deployment"
          },
          "event_time": {
            "type": "integer",
            "format": "int64",
            "description": "Epoch millisecond timestamp at which the deployment occurred"
          },
          "properties": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Arbitrary key-value pairs used to pass additional information about this deployment"
          },
          "source_control": {
            "$ref": "#/components/schemas/SourceControl"
          },
          "environment_name": {
            "type": "string",
            "description": "Name of the environment associated with this deployment. Absent when the deployment carries no environment or the environment has since been deleted."
          }
        }
      },
      "TestTypeEnum": {
        "description": "Type of test",
        "type": "string",
        "enum": [
          "api",
          "browser",
          "performance",
          "mobile"
        ]
      },
      "ResolvedTest": {
        "description": "The version a selected test resolved to when mabl accepted the event",
        "type": "object",
        "required": [
          "test_id",
          "test_variant_id",
          "branch"
        ],
        "properties": {
          "branch": {
            "type": "string",
            "description": "The mabl branch the version came from, which is the selection's mabl branch, or master when the test has no version there"
          },
          "test_variant_id": {
            "type": "string",
            "description": "The id of the resolved test version, in the form test_id:version. Test runs in the deployment results report it as their test_id"
          },
          "test_id": {
            "type": "string",
            "description": "The id of the selected test"
          }
        }
      },
      "ExecutionMetrics": {
        "type": "object",
        "properties": {
          "running": {
            "description": "The number of executions that are still running",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "total": {
            "description": "The total number of executions",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "passed": {
            "description": "The number of executions that passed",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "failed": {
            "description": "The number of executions that failed",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "terminated": {
            "description": "The total number of executions that were terminated before completion",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "skipped": {
            "description": "The number of executions that were skipped",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          }
        }
      },
      "SourceControl": {
        "type": "object",
        "properties": {
          "pull_requests": {
            "type": "array",
            "description": "Related pull requests",
            "items": {
              "$ref": "#/components/schemas/SourceControlPullRequest"
            }
          },
          "revisions": {
            "type": "array",
            "description": "all source revision ids associated with this object",
            "items": {
              "type": "string"
            }
          },
          "branches": {
            "type": "array",
            "description": "Related branches",
            "items": {
              "$ref": "#/components/schemas/SourceControlBranch"
            }
          },
          "repository": {
            "$ref": "#/components/schemas/SourceControlRepository"
          },
          "revision": {
            "type": "string",
            "description": "the primary source revision associated with this object"
          },
          "authors": {
            "type": "array",
            "description": "Related authors. Should be at least one",
            "items": {
              "$ref": "#/components/schemas/SourceControlAuthor"
            }
          }
        }
      },
      "ErrorResponseGeneric": {
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "SourceControlPullRequest": {
        "description": "the pull request associated with this object",
        "type": "object",
        "properties": {
          "number": {
            "type": "integer",
            "description": "the number associated with the pull request (repository unique)"
          },
          "html_url": {
            "type": "string",
            "description": "HTML page url to view pull request object"
          },
          "id": {
            "type": "string",
            "description": "vendor unique pull request identifier (immutable)"
          },
          "title": {
            "type": "string",
            "description": "the title of the pull request"
          }
        }
      },
      "SourceControlRepository": {
        "description": "the SCM repository associated with this object",
        "type": "object",
        "required": [
          "id",
          "name",
          "owner_name",
          "html_url"
        ],
        "properties": {
          "owner": {
            "$ref": "#/components/schemas/SourceControlRepositoryOwner"
          },
          "checkout_url": {
            "type": "string",
            "description": "SCM remote checkout path"
          },
          "full_name": {
            "type": "string",
            "description": "vendor unique name to identify this repo across all vendor's repos"
          },
          "html_url": {
            "type": "string",
            "description": "HTML page url to view branch tree"
          },
          "name": {
            "type": "string",
            "description": "repository name unique within owner scope"
          },
          "is_public": {
            "type": "boolean",
            "description": "true if repository publicly visible"
          },
          "id": {
            "type": "string",
            "description": "vendor unique repository id (immutable)"
          }
        }
      },
      "FailureRootCauseAnalysis": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "string",
            "description": "The summary of the analysis for the run failure",
            "readOnly": true
          },
          "evidence_details": {
            "type": "string",
            "description": "Agent-generated detailed evidence supporting the analysis, if available",
            "readOnly": true
          },
          "failure_category_id": {
            "type": "string",
            "description": "The suggested failure category if applicable",
            "readOnly": true
          },
          "headline": {
            "type": "string",
            "description": "The short summary of the run analysis; typically limited to one sentence",
            "readOnly": true
          }
        }
      },
      "Tag": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "description": "tag name",
            "type": "string"
          }
        }
      },
      "TestRunResult": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseTestRunResult"
          },
          {
            "properties": {
              "run_multiplier_index": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "readOnly": true,
                "description": "Zero-indexed run multiplier index for this run"
              },
              "stop_time": {
                "description": "(deprecated, use completed_time) The time this test run stopped",
                "type": "integer",
                "format": "int64",
                "readOnly": true
              },
              "environment_id": {
                "type": "string",
                "description": "the id of the environment associated with this run",
                "readOnly": true
              },
              "browser_type": {
                "type": "string",
                "description": "the type of browser associated with this run",
                "readOnly": true
              },
              "scenario_name": {
                "type": "string",
                "description": "the scenario name associated with this run, if any",
                "readOnly": true
              },
              "termination_reason": {
                "type": "string",
                "description": "Termination reason when status is terminated (mirrors TestRun.termination_reason values, e.g. usage_quota_exceeded)"
              },
              "application_id": {
                "type": "string",
                "description": "the id of the application associated with this run",
                "readOnly": true
              },
              "branch": {
                "type": "string",
                "description": "The branch this run was requested against, taken from the branch on the triggering deployment event or plan run override and, failing that, the environment's branch. This is the branch asked for, which is not always the branch the executed test version came from: when a branch has not modified a test, the run executes that test's master version. The version that actually ran is the trailing version suffix on test_id, so a caller can compare it against the test's source_control_tags to tell a branch-specific version from an inherited master one.",
                "readOnly": true
              },
              "credentials_id": {
                "type": "string",
                "description": "The id of the credentials this run used, if any. This is the plan or deployment override when the run carried one, and otherwise the default set on the test version that ran.",
                "readOnly": true
              },
              "start_time": {
                "description": "(deprecated, use started_time) The time this test run started",
                "type": "integer",
                "format": "int64",
                "readOnly": true
              },
              "success": {
                "type": "boolean",
                "description": "true if the test run completed successfully",
                "readOnly": true
              },
              "journey_execution_id": {
                "type": "string",
                "description": "(deprecated, use id instead) The test run ID",
                "readOnly": true
              },
              "href": {
                "type": "string",
                "description": "URL for retrieving the test run",
                "readOnly": true
              },
              "initial_url": {
                "type": "string",
                "description": "the URL where the test started",
                "readOnly": true
              },
              "app_href": {
                "type": "string",
                "description": "URL for viewing the test run results in the mabl app",
                "readOnly": true
              }
            }
          }
        ],
        "description": "Provides information about the result of a test run",
        "type": "object",
        "required": [
          "journey_id",
          "journey_execution_id",
          "href",
          "app_href"
        ]
      },
      "SourceControlBranch": {
        "description": "the SCM branch associated with this object",
        "type": "object",
        "required": [
          "name",
          "html_url"
        ],
        "properties": {
          "html_url": {
            "type": "string",
            "description": "HTML page url to view branch tree"
          },
          "name": {
            "type": "string",
            "description": "repository unique branch name"
          }
        }
      },
      "SelectedTestCredentials": {
        "description": "The login credentials one selected test runs with",
        "type": "object",
        "required": [
          "test_id",
          "credentials_id"
        ],
        "properties": {
          "credentials_id": {
            "type": "string",
            "maxLength": 64,
            "description": "The id of the login credentials the test runs with"
          },
          "test_id": {
            "type": "string",
            "description": "The id of a test in test_ids"
          }
        }
      },
      "TestRunFailureSummary": {
        "description": "Information useful for diagnosing test run failures",
        "type": "object",
        "properties": {
          "step_number": {
            "type": "integer",
            "format": "int32",
            "description": "Step number within the flow where the failure occurred"
          },
          "image_href": {
            "type": "string",
            "description": "URL of an image showing the error"
          },
          "image_uri": {
            "type": "string",
            "description": "URL of an image showing the error"
          },
          "flow_id": {
            "type": "string",
            "description": "ID of the flow in which the failure occurred"
          },
          "flow_name": {
            "type": "string",
            "description": "Name of the flow in which the failure occurred, if any"
          },
          "step_id": {
            "type": "string",
            "description": "ID of the step (with respect to the flow) where the failure occurred"
          },
          "step_id_in_test": {
            "type": "string",
            "description": "ID of the step (with respect to the test) where the failure occurred"
          },
          "error": {
            "type": "string",
            "description": "Unexpected error or formatted assertion failure that was recorded"
          },
          "assert_failure": {
            "$ref": "#/components/schemas/AssertFailure",
            "description": "Assert failure details if test run failed due to an assertion failure"
          },
          "image_artifact_url": {
            "type": "string",
            "description": "API url of the image that will redirect to a newly signed image url"
          }
        }
      },
      "DeploymentPlanSummary": {
        "description": "Plans that run for this deployment",
        "type": "object",
        "properties": {
          "plan_run_id": {
            "type": "string",
            "description": "The ID of run of the plan"
          },
          "plan_id": {
            "type": "string",
            "description": "Unique ID for this plan"
          }
        }
      },
      "ExecutionResult": {
        "description": "Summary of plan/test execution results",
        "type": "object",
        "properties": {
          "plan_execution_metrics": {
            "$ref": "#/components/schemas/ExecutionMetrics",
            "readOnly": true
          },
          "executions": {
            "type": "array",
            "description": "Complete list of all plan runs",
            "items": {
              "$ref": "#/components/schemas/ExecutionSummary"
            },
            "readOnly": true
          },
          "failure_analysis": {
            "$ref": "#/components/schemas/FailureRootCauseAnalysis",
            "description": "Agent-generated failure analysis for this deployment event, if available",
            "readOnly": true
          },
          "journey_execution_metrics": {
            "$ref": "#/components/schemas/ExecutionMetrics",
            "readOnly": true
          },
          "event_status": {
            "$ref": "#/components/schemas/EventStatus",
            "readOnly": true
          }
        }
      },
      "PlanExecutionResult": {
        "description": "Provides information about the result of a plan execution",
        "type": "object",
        "required": [
          "id",
          "href"
        ],
        "properties": {
          "is_retry": {
            "type": "boolean",
            "description": "true if this plan run is a retry of a previously failed execution",
            "readOnly": true
          },
          "id": {
            "type": "string",
            "description": "The plan run ID",
            "readOnly": true
          },
          "status_cause": {
            "type": "string",
            "description": "Cause for setting given status, such as failure cause",
            "readOnly": true
          },
          "href": {
            "type": "string",
            "description": "URL for retrieving the plan run",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "description": "Current status of the plan run",
            "enum": [
              "queued",
              "pre_execution",
              "scheduling",
              "scheduled",
              "succeeded",
              "failed",
              "cancelled",
              "post_execution",
              "completed",
              "terminated"
            ],
            "readOnly": true
          },
          "retry_of_id": {
            "type": "string",
            "description": "if is_retry is true, this is the ID of the plan run that this retry is associated with"
          }
        }
      },
      "TestSelection": {
        "description": "An explicit set of tests to run for a deployment, in place of matching stored plans by label. mabl runs them as one synthesized plan whose identity is scoped to the event, so the runs appear on the deployment results page like any other deployment run. Supports browser or API tests, without mixing types. Each test runs at its version on the selection's mabl branch, falling back to master when it has none there. That branch is the event's branch (or source_control_tag), else the deployment's branch, else the snapshot action's from, else the environment's branch, else master, and must be the same for every deployment that can run the selected test type. A branch mabl does not have is not an error: every test runs at master, and resolved_tests shows it. The snapshot action's from is the exception and must name an existing branch. A test with no version on the branch or master is refused. An environment's snapshot branch has no master fallback, so a test missing from the snapshot is refused. Each enabled test requires a compatible deployment. The first run runs the versions in resolved_tests. Retries, from retry_failed_tests or a manual rerun, resolve the branch again and run any later edit. Flows are not pinned; they resolve on the branch when each test starts.",
        "type": "object",
        "required": [
          "test_ids",
          "source"
        ],
        "properties": {
          "test_ids": {
            "type": "array",
            "description": "The ids of the tests to run, at most 50 entries. An id repeated in the list runs once",
            "minItems": 1,
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "credentials": {
            "type": "array",
            "maxItems": 50,
            "description": "Optional login credentials for individual selected tests, such as the plan_credentials_id a test impact analysis reports for each test. A listed test logs in with its credentials_id instead of plan_overrides.credentials_id, and a test not listed runs with plan_overrides as usual. Each test_id must be in test_ids and listed once, and each credentials_id must be credentials in this workspace; otherwise the whole event is refused and nothing runs",
            "items": {
              "$ref": "#/components/schemas/SelectedTestCredentials"
            }
          },
          "name": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional display name for the synthesized plan"
          },
          "retry_failed_tests": {
            "type": "boolean",
            "description": "When true, if any test in the selection fails, mabl reruns only the failed tests, once, on the same deployment event. The event's succeeded is true if the rerun passes; succeeded_first_attempt stays false so a pass on the second attempt is still visible. The rerun resolves each test's branch again, so it runs the latest version there. Each rerun test counts as a test run. Off when omitted"
          },
          "impact_session_id": {
            "type": "string",
            "maxLength": 64,
            "description": "Optional id of the test impact analysis session that chose these tests. It must be a test impact session in this workspace that recorded the tests it returned, and every entry in test_ids must be one of them; otherwise the event is rejected with a 400 and nothing runs. The deployment event is recorded onto the session so the analysis and what it triggered stay linked; if that record cannot be written, link_warning says so and the event and its runs are unaffected"
          },
          "source": {
            "type": "string",
            "description": "Whether a person chose this set of tests or software did. Which software is recorded by impact_session_id, which names the session rather than a category",
            "enum": [
              "agent",
              "user"
            ]
          },
          "skipped_tests": {
            "type": "array",
            "readOnly": true,
            "description": "Tests that were accepted but not run, with the reason. Set by mabl",
            "items": {
              "$ref": "#/components/schemas/SkippedTest"
            }
          },
          "resolved_tests": {
            "type": "array",
            "readOnly": true,
            "description": "The version each test resolved to, and the mabl branch that version came from. Set by mabl",
            "items": {
              "$ref": "#/components/schemas/ResolvedTest"
            }
          }
        }
      },
      "ExecutionSummary": {
        "type": "object",
        "properties": {
          "journey_executions": {
            "type": "array",
            "description": "The test runs in this plan",
            "items": {
              "$ref": "#/components/schemas/TestRunResult"
            },
            "readOnly": true
          },
          "start_time": {
            "description": "Plan run start time",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "journeys": {
            "type": "array",
            "description": "The tests in this plan",
            "items": {
              "$ref": "#/components/schemas/TestSummary"
            },
            "readOnly": true
          },
          "stop_time": {
            "description": "Plan run end time",
            "type": "integer",
            "format": "int64",
            "readOnly": true
          },
          "success": {
            "description": "true if the plan completed successfully",
            "type": "boolean",
            "readOnly": true
          },
          "status_cause": {
            "type": "string",
            "description": "Cause for setting given status, such as failure cause",
            "readOnly": true
          },
          "plan": {
            "$ref": "#/components/schemas/PlanSummary",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "description": "Current status of the plan run",
            "enum": [
              "queued",
              "pre_execution",
              "scheduling",
              "scheduled",
              "succeeded",
              "failed",
              "cancelled",
              "post_execution",
              "completed",
              "terminated"
            ],
            "readOnly": true
          },
          "plan_execution": {
            "$ref": "#/components/schemas/PlanExecutionResult",
            "readOnly": true
          }
        }
      },
      "PlanSummary": {
        "type": "object",
        "required": [
          "id",
          "href",
          "app_href"
        ],
        "properties": {
          "name": {
            "description": "plan name",
            "type": "string",
            "readOnly": true
          },
          "id": {
            "description": "plan id",
            "type": "string",
            "readOnly": true
          },
          "href": {
            "type": "string",
            "description": "URL for retrieving the plan",
            "readOnly": true
          },
          "app_href": {
            "type": "string",
            "description": "URL for viewing the plan in the mabl app",
            "readOnly": true
          },
          "tags": {
            "type": "array",
            "description": "tags associated with the plan",
            "items": {
              "$ref": "#/components/schemas/Tag"
            },
            "readOnly": true
          }
        }
      },
      "EventStatus": {
        "type": "object",
        "properties": {
          "succeeded_by_plan": {
            "type": "object",
            "additionalProperties": {
              "type": "boolean"
            },
            "description": "Map of plan ID to boolean indicating whether the plan passed",
            "readOnly": true
          },
          "succeeded_with_retries": {
            "type": "boolean",
            "description": "True if all associated plan runs passed taking retries into account",
            "readOnly": true
          },
          "succeeded_first_attempt": {
            "type": "boolean",
            "description": "True if all associated plan runs passed on the first attempt",
            "readOnly": true
          },
          "succeeded": {
            "type": "boolean",
            "description": "True if succeeded_first_attempt is true or succeeded_with_retries is true",
            "readOnly": true
          }
        }
      },
      "SourceControlAuthor": {
        "description": "the SCM author associated with this object",
        "type": "object",
        "required": [
          "id",
          "user_name",
          "html_url",
          "avatar_url"
        ],
        "properties": {
          "user_type": {
            "description": "repository name unique within owner scope",
            "type": "string"
          },
          "avatar_url": {
            "type": "string",
            "description": "author avatar image URL"
          },
          "user_name": {
            "type": "string",
            "description": "author username name (mutable)"
          },
          "html_url": {
            "type": "string",
            "description": "HTML page url to view author"
          },
          "name": {
            "type": "string",
            "description": "author full name (mutable)"
          },
          "id": {
            "type": "string",
            "description": "vendor unique author id (invariant)"
          },
          "email": {
            "type": "string",
            "description": "author email"
          }
        }
      },
      "TestSummary": {
        "type": "object",
        "required": [
          "id",
          "href",
          "app_href"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "test name",
            "readOnly": true
          },
          "id": {
            "type": "string",
            "description": "Test id",
            "readOnly": true
          },
          "href": {
            "type": "string",
            "description": "URL for retrieving the test",
            "readOnly": true
          },
          "app_href": {
            "type": "string",
            "description": "URL for viewing the test in the mabl app",
            "readOnly": true
          },
          "tags": {
            "type": "array",
            "description": "tags associated with this test",
            "items": {
              "$ref": "#/components/schemas/Tag"
            },
            "readOnly": true
          }
        }
      },
      "SourceControlRepositoryOwner": {
        "description": "the SCM repository associated with this object",
        "type": "object",
        "required": [
          "id",
          "name",
          "html_url",
          "owner_type"
        ],
        "properties": {
          "avatar_url": {
            "type": "string",
            "description": "owner avatar image URL"
          },
          "html_url": {
            "type": "string",
            "description": "HTML page url to view branch tree"
          },
          "name": {
            "type": "string",
            "description": "repository name unique within owner scope"
          },
          "id": {
            "type": "string",
            "description": "vendor unique repository id (immutable)"
          },
          "owner_type": {
            "description": "repository name unique within owner scope",
            "type": "string"
          }
        }
      },
      "TestRunResultOutcomeEnum": {
        "type": "string",
        "enum": [
          "passed",
          "failed",
          "stopped"
        ]
      },
      "TestSource": {
        "description": "Where the test lives",
        "type": "string",
        "enum": [
          "mabl_cloud",
          "external",
          "mabl_local",
          "mabl_agent"
        ]
      },
      "SkippedTest": {
        "description": "A test that a selection named but that mabl did not run",
        "type": "object",
        "required": [
          "test_id",
          "reason"
        ],
        "properties": {
          "reason": {
            "type": "string",
            "description": "Why the test was not run",
            "enum": [
              "disabled"
            ]
          },
          "test_id": {
            "type": "string",
            "description": "The id of the test that was not run"
          }
        }
      },
      "AssertFailure": {
        "description": "Details about assert failure",
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "description": "Assert failure description without expected/found values to eliminate the need for parsing downstream"
          },
          "found": {
            "type": "string",
            "description": "Value actually found during test execution"
          },
          "expected": {
            "type": "string",
            "description": "Expected value where applicable"
          }
        }
      },
      "DeploymentEventQueryResult": {
        "type": "object",
        "required": [
          "deployments"
        ],
        "properties": {
          "cursor": {
            "type": "string",
            "description": "Cursor used for pagination",
            "readOnly": true
          },
          "deployments": {
            "type": "array",
            "description": "All deployments that matched the query",
            "readOnly": true,
            "items": {
              "$ref": "#/components/schemas/DeploymentEventResult"
            }
          }
        }
      }
    },
    "responses": {
      "ErrorResponse": {
        "description": "Unknown error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponseGeneric"
            }
          }
        }
      },
      "ErrorResponse401": {
        "description": "User not authenticated",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponseGeneric"
            }
          }
        }
      },
      "ErrorResponse403": {
        "description": "User not authorized",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponseGeneric"
            }
          }
        }
      },
      "ErrorResponse400": {
        "description": "Invalid or missing parameter",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponseGeneric"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "basicAuth": []
    },
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/events/deployment": {
      "get": {
        "summary": "Query Deployment Events",
        "operationId": "queryDeploymentEvents",
        "description": "Used to query deployment events",
        "responses": {
          "200": {
            "description": "Results of the query",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentEventQueryResult"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse400"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse401"
          },
          "403": {
            "$ref": "#/components/responses/ErrorResponse403"
          },
          "default": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        },
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "workspace_id",
            "description": "ID of the workspace for which to query deployment events",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "environment_id",
            "description": "ID of the environment for which to query deployment events",
            "required": false
          },
          {
            "schema": {
              "format": "int64",
              "type": "integer"
            },
            "in": "query",
            "name": "start_time",
            "description": "Start time of the query range, in epoch milliseconds.  Oldest allowed value is 400d in the past.",
            "required": false
          },
          {
            "schema": {
              "format": "int64",
              "type": "integer"
            },
            "in": "query",
            "name": "end_time",
            "description": "End time of the query range, in epoch milliseconds.  Oldest allowed value is 400d in the past.",
            "required": false
          },
          {
            "schema": {
              "default": true,
              "type": "boolean"
            },
            "in": "query",
            "name": "include_test_executions",
            "description": "If false, excludes executions from the run_result in the response, improving performance for large result sets.",
            "required": false
          },
          {
            "schema": {
              "default": 10,
              "format": "int32",
              "maximum": 100,
              "type": "integer",
              "minimum": 1
            },
            "in": "query",
            "name": "limit",
            "description": "The limit to use for pagination. Defaults to 10 if not specified; maximum limit is 100.",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "cursor",
            "description": "The cursor to use for pagination",
            "required": false
          }
        ],
        "tags": [
          "Event"
        ]
      }
    }
  },
  "tags": [
    {
      "name": "Event"
    }
  ]
}
```