---
title: Annotations
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Annotations
---

# Annotations
Copy pageCopied
Add annotations to dashboards and notebooks to mark events such as deployments, incidents, or other notable moments in time.

## List annotations → preview{% #list-annotations %}

| Datadog site      | API endpoint                                        |
| ----------------- | --------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/annotation |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/annotation |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/annotation      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/annotation      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/annotation  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/annotation     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/annotation |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/annotation |

## Create an annotation → preview{% #create-an-annotation %}

| Datadog site      | API endpoint                                         |
| ----------------- | ---------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/annotation |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/annotation |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/annotation      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/annotation      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/annotation  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/annotation     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/annotation |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/annotation |

## Get annotations for a page → preview{% #get-annotations-for-a-page %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/annotation/page/{page_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/annotation/page/{page_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/annotation/page/{page_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/annotation/page/{page_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/annotation/page/{page_id}  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/annotation/page/{page_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/annotation/page/{page_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/annotation/page/{page_id} |

## Update an annotation → preview{% #update-an-annotation %}

| Datadog site      | API endpoint                                                        |
| ----------------- | ------------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/annotation/{annotation_id} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/annotation/{annotation_id} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/annotation/{annotation_id}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/annotation/{annotation_id}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/annotation/{annotation_id}  |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/annotation/{annotation_id}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/annotation/{annotation_id} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/annotation/{annotation_id} |

## Delete an annotation → preview{% #delete-an-annotation %}

| Datadog site      | API endpoint                                                           |
| ----------------- | ---------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/annotation/{annotation_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/annotation/{annotation_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/annotation/{annotation_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/annotation/{annotation_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/annotation/{annotation_id}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/annotation/{annotation_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/annotation/{annotation_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/annotation/{annotation_id} |