---
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`

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)