---
title: "Send a deployment event"
method: POST
path: "/api/v2/dora/deployment"
tags: ["DORA Metrics"]
---

# Send a deployment event

`POST /api/v2/dora/deployment`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/dora/deployment`
- Auth: API key in header `DD-API-KEY`

Use this API endpoint to provide deployment data.

This is necessary for:
- Deployment Frequency
- Change Lead Time
- Change Failure Rate
- Failed Deployment Recovery Time

## Request body

- DORADeploymentRequest: Request to create a DORA deployment event.
  - `data` DORADeploymentRequestData, required: The JSON:API data.
    - `attributes` DORADeploymentRequestAttributes, required: Attributes to create a DORA deployment event.
      - `custom_tags` string[], nullable: A list of user-defined tags. The tags must follow the `key:value` pattern. Up to 100 may be added per event.
      - `env` string: Environment name to where the service was deployed.
      - `finished_at` integer, required: Unix timestamp when the deployment finished. It must be in nanoseconds, milliseconds, or seconds.
      - `git` DORAGitInfo: Git info for DORA Metrics events.
        - `commit_sha` string, required: Git Commit SHA.
        - `repository_url` string, required: Git Repository URL
      - `id` string: Deployment ID. Must be 16-128 characters and contain only alphanumeric characters, hyphens, underscores, periods, and colons (a-z, A-Z, 0-9, -, _, ., :).
      - `service` string, required: Service name.
      - `started_at` integer, required: Unix timestamp when the deployment started. It must be in nanoseconds, milliseconds, or seconds.
      - `team` string: Name of the team owning the deployed service. If not provided, this is automatically populated with the team associated with the service in the Service Catalog.
      - `version` string: Version to correlate with [APM Deployment Tracking](https://docs.datadoghq.com/tracing/services/deployment_tracking/).

## Response `200`

OK

- DORADeploymentResponse: Response after receiving a DORA deployment event.
  - `data` DORADeploymentResponseData, required: The JSON:API data.
    - `id` string, required: The ID of the received DORA deployment event.
    - `type` 'dora_deployment': JSON:API type for DORA deployment events.

## Other responses

- `202`: OK - but delayed due to incident
- `400`: Bad Request
- `403`: Not Authorized
- `429`: Too many requests

---

[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)