---
title: "Trigger a deployment gate evaluation"
method: POST
path: "/api/v2/deployments/gates/evaluation"
tags: ["Deployment Gates"]
---

# Trigger a deployment gate evaluation

`POST /api/v2/deployments/gates/evaluation`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/deployments/gates/evaluation`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Triggers an asynchronous deployment gate evaluation for the given service and environment.
Returns an evaluation ID that can be used to poll for the result via the
`GET /api/v2/deployments/gates/evaluation/{id}` endpoint.

When the `configuration` attribute is provided, rules are evaluated inline from that configuration
and no pre-configured gate is required. When `configuration` is omitted, rules are resolved from the
gate pre-configured for the given service and environment through the Datadog UI, API, or Terraform.

## Request body

- DeploymentGatesEvaluationRequest: Request body for triggering a deployment gate evaluation.
  - `data` DeploymentGatesEvaluationRequestData, required: Data for a deployment gate evaluation request.
    - `attributes` DeploymentGatesEvaluationRequestAttributes, required: Attributes for a deployment gate evaluation request. When `configuration` is provided, rules are evaluated inline from that configuration. When omitted, rules are resolved from the preconfigured gate for the given service and environment.
      - `configuration` DeploymentGatesEvaluationConfiguration: Inline rule definitions for a deployment gate evaluation. When provided, rules are evaluated directly from this configuration instead of using the preconfigured gate rules. At least one rule is required.
        - `dry_run` boolean: Gate-level dry run. When enabled, the rules are evaluated normally but the gate always returns `pass`. The real result is visible in the Datadog UI.
        - `rules` DeploymentGatesEvaluationRule[], required: The list of rules to evaluate. At least one rule is required.
          - union: A rule to evaluate as part of a deployment gate evaluation.
            - DeploymentGatesMonitorRule: A monitor rule to evaluate as part of a deployment gate evaluation.
              - …
            - DeploymentGatesFDDRule: A faulty deployment detection rule to evaluate as part of a deployment gate evaluation.
              - …
      - `env` string, required: The environment of the deployment.
      - `identifier` string: The identifier of the deployment gate. Defaults to "default".
      - `primary_tag` string: A primary tag to scope APM Faulty Deployment Detection rules.
      - `service` string, required: The service being deployed.
      - `version` string: The version of the deployment. Required for APM Faulty Deployment Detection rules.
    - `type` 'deployment_gates_evaluation_request', required: JSON:API type for a deployment gate evaluation request.

## Response `202`

Accepted

- DeploymentGatesEvaluationResponse: Response for a deployment gate evaluation request.
  - `data` DeploymentGatesEvaluationResponseData: Data for a deployment gate evaluation response.
    - `attributes` DeploymentGatesEvaluationResponseAttributes, required: Attributes for a deployment gate evaluation response.
      - `evaluation_id` string, required: The unique identifier of the gate evaluation.
    - `id` string, uuid, required: The unique identifier of the evaluation response.
    - `type` 'deployment_gates_evaluation_response', required: JSON:API type for a deployment gate evaluation response.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Deployment gate not found.
- `429`: Too many requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)