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

# Observability Pipelines

Observability Pipelines allows you to collect and process logs within your own infrastructure, and then route them to downstream integrations.

## List pipelines →{% #list-pipelines %}

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

## Create a new pipeline →{% #create-a-new-pipeline %}

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

## Get a specific pipeline →{% #get-a-specific-pipeline %}

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

## Update a pipeline →{% #update-a-pipeline %}

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

## Delete a pipeline →{% #delete-a-pipeline %}

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

## Validate an observability pipeline →{% #validate-an-observability-pipeline %}

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