Language

English Français 日本語 한국어 Español

Datadog Site

Site help
US1 US3 US5 EU AP1 AP2 US1-FED US2-FED

Annotations

copy Image Copy pageCopied

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

List annotations → preview

GET https://api.ap1.datadoghq.com/api/v2/annotationhttps://api.ap2.datadoghq.com/api/v2/annotationhttps://api.datadoghq.eu/api/v2/annotationhttps://api.ddog-gov.com/api/v2/annotationhttps://api.us2.ddog-gov.com/api/v2/annotationhttps://api.datadoghq.com/api/v2/annotationhttps://api.us3.datadoghq.com/api/v2/annotationhttps://api.us5.datadoghq.com/api/v2/annotation

Create an annotation → preview

POST https://api.ap1.datadoghq.com/api/v2/annotationhttps://api.ap2.datadoghq.com/api/v2/annotationhttps://api.datadoghq.eu/api/v2/annotationhttps://api.ddog-gov.com/api/v2/annotationhttps://api.us2.ddog-gov.com/api/v2/annotationhttps://api.datadoghq.com/api/v2/annotationhttps://api.us3.datadoghq.com/api/v2/annotationhttps://api.us5.datadoghq.com/api/v2/annotation

Get annotations for a page → preview

GET https://api.ap1.datadoghq.com/api/v2/annotation/page/{page_id}https://api.ap2.datadoghq.com/api/v2/annotation/page/{page_id}https://api.datadoghq.eu/api/v2/annotation/page/{page_id}https://api.ddog-gov.com/api/v2/annotation/page/{page_id}https://api.us2.ddog-gov.com/api/v2/annotation/page/{page_id}https://api.datadoghq.com/api/v2/annotation/page/{page_id}https://api.us3.datadoghq.com/api/v2/annotation/page/{page_id}https://api.us5.datadoghq.com/api/v2/annotation/page/{page_id}

Update an annotation → preview

PUT https://api.ap1.datadoghq.com/api/v2/annotation/{annotation_id}https://api.ap2.datadoghq.com/api/v2/annotation/{annotation_id}https://api.datadoghq.eu/api/v2/annotation/{annotation_id}https://api.ddog-gov.com/api/v2/annotation/{annotation_id}https://api.us2.ddog-gov.com/api/v2/annotation/{annotation_id}https://api.datadoghq.com/api/v2/annotation/{annotation_id}https://api.us3.datadoghq.com/api/v2/annotation/{annotation_id}https://api.us5.datadoghq.com/api/v2/annotation/{annotation_id}

Delete an annotation → preview

DELETE https://api.ap1.datadoghq.com/api/v2/annotation/{annotation_id}https://api.ap2.datadoghq.com/api/v2/annotation/{annotation_id}https://api.datadoghq.eu/api/v2/annotation/{annotation_id}https://api.ddog-gov.com/api/v2/annotation/{annotation_id}https://api.us2.ddog-gov.com/api/v2/annotation/{annotation_id}https://api.datadoghq.com/api/v2/annotation/{annotation_id}https://api.us3.datadoghq.com/api/v2/annotation/{annotation_id}https://api.us5.datadoghq.com/api/v2/annotation/{annotation_id}