Manage Datadog log pipelines and processors via the API

domain: docs.datadoghq.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Authenticate API calls with the headers DD-API-KEY and DD-APPLICATION-KEY (application key must have the logs_write_pipelines scope)
  2. Create a pipeline with POST /api/v1/logs/config/pipelines; provide a name, filter.query string (e.g., source:nginx) to scope which logs enter the pipeline, and an is_enabled flag
  3. Add processors inside the pipeline by including a processors array in the create or update body; each processor object requires a type (e.g., grok-parser, date-remapper, attribute-remapper, string-builder-processor), a name, and type-specific config fields
  4. Update an existing pipeline (to add, reorder, or modify processors) with PUT /api/v1/logs/config/pipelines/{pipelineId}; this replaces the entire pipeline definition, so always GET the current state first and merge your changes
  5. Control pipeline execution order with PUT /api/v1/logs/config/pipeline-order; the body is {"pipeline_ids": ["id1", "id2"]} in the desired evaluation order—pipelines are evaluated top-to-bottom and the first matching pipeline's processors run
  6. Manage pipelines as code using the Datadog Terraform provider (resource datadog_logs_custom_pipeline) or Pulumi to version-control and review pipeline changes through normal CI/CD workflows

Known gotchas

Related routes

Configure Datadog log pipelines and processors to parse and enrich logs
docs.datadoghq.com · 5 steps · unrated
Create and update Datadog monitors via the API
docs.datadoghq.com · 5 steps · unrated
Configure Datadog Observability Pipelines to sample logs by pattern and reduce ingestion volume before data reaches Datadog
docs.datadoghq.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans