Datadog

Datadog API V2 Collection

Collection of all Datadog Public endpoints.

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Collection of all Datadog Public endpoints.

Endpoints 400

AI Gateway

  • GETList AI Gateway budgets/api/v2/budgetsList spend budgets for the organization, including active-window spend and effective capacity.
  • POSTCreate an AI Gateway budget/api/v2/budgetsCreate a spend budget. Scope tags may include provider, model, and custom dimensions. Reserved metadata keys are rejected.
  • GETGet an AI Gateway budget/api/v2/budgets/:idGet a spend budget by ID, including its capacity, scope, reset window, warning threshold, and enforcement mode.
  • DELETEArchive an AI Gateway budget/api/v2/budgets/:idArchive a spend budget by ID while retaining its accounting history.
  • PATCHUpdate an AI Gateway budget/api/v2/budgets/:idUpdate a budget's mutable definition. Capacity changes apply to future accounting periods unless apply_to_current_period is true.
  • GETGet an AI Gateway budget's current period/api/v2/budgets/:id/current-periodGet the active accounting window, enforced capacity, and current spend.
  • GETList AI Gateway budget instances/api/v2/budgets/:id/instances?window=2024-01-01T00:00:00Z&split_dim=user_id=11111111-1111-1111-1111-111111111111,tag:env=prod&sort=spend_desc&limit=50&offset=0List instance counters for an accounting window. Legacy fixed-scope budgets return one pooled row with an empty instance_key. Omit window to use the current…
  • POSTOverride a budget instance's capacity/api/v2/budgets/:id/instances/capacityOverride active-period capacity for one instance of a template budget, identified by its instance_key. Other instances and the budget's default capacity are…
  • GETList AI Gateway budget instance dimension values/api/v2/budgets/:id/instances/dimensions?window=2024-01-01T00:00:00Z&split_dim=user_id=11111111-1111-1111-1111-111111111111,tag:env=prod&dim=user_id&query=prod&value=11111111-1111-1111-1111-111111111111&limit=50Search the values that a template budget's split dimensions take across its instance counters in an accounting window. Each dimension returns its top values…
  • POSTReset a budget instance's spend/api/v2/budgets/:id/instances/resetReset active-period spend for one instance of a template budget, identified by its instance_key. The reset is retained in the budget adjustment audit history.…
  • GETGet an AI Gateway budget instance summary/api/v2/budgets/:id/instances/summary?window=2024-01-01T00:00:00Z&split_dim=user_id=11111111-1111-1111-1111-111111111111,tag:env=prodAggregate counters for an accounting window, including total spend and the numbers of instances at or above the warning threshold and capacity. Use split_dim…
  • GETGet the AI Gateway data capture configuration/api/v2/data-capture/configurationGet the organization default mode, scoped capture overrides, and configuration revision.
  • POSTCreate an AI Gateway data capture override/api/v2/data-capture/overridesCreate a scoped override with a client-generated UUID and the current configuration_revision. If the override can enable full capture for more traffic, set…
  • PUTReplace an AI Gateway data capture override/api/v2/data-capture/overrides/:idReplace an override using its revision and the current configuration_revision. Changes to capture overrides don't affect routing rules. Returns HTTP 409 when…
  • DELETEDelete an AI Gateway data capture override/api/v2/data-capture/overrides/:idDelete an override using its revision and the current configuration_revision. If deleting the override can enable full capture for affected traffic, set…
  • GETGet AI Gateway governance controls/api/v2/governanceGet the organization-wide AI Gateway governance settings, which are the default data capture mode and whether requests must reach providers covered by a zero…
  • PUTReplace AI Gateway governance controls/api/v2/governanceReplace the organization-wide AI Gateway governance settings, which are the default data capture mode and whether requests must reach providers covered by a…
  • GETList AI Gateway model groups/api/v2/model-groupsList model groups the user can view. The organization-wide policy has id "default" and explicit model, provider, and route selections. Missing or empty…
  • POSTCreate an AI Gateway model group/api/v2/model-groupsCreate an AI Gateway model group from a name and any combination of model catalog entries and routing rules, with optional fast-mode and reasoning limits and…
  • GETGet an AI Gateway model group/api/v2/model-groups/:idGet a named policy or the explicit organization-wide policy by id "default". Requires configuration read permission; named policies also require view access.…
  • DELETEDelete an AI Gateway model group/api/v2/model-groups/:idDelete a named model group. The organization-wide policy cannot be deleted. Requires configuration write permission and edit access to the group.
  • PATCHUpdate an AI Gateway model group/api/v2/model-groups/:idUpdate a model group. For id "default", save membership and request options atomically with expected_revision. Empty selections grant no organization-wide…
  • GETList AI Gateway models by canonical ID/api/v2/modelsList all model catalog entries grouped by canonical model ID. Requires ai_gateway_config_read and provider View. Catalog and pricing metadata inherit provider…
  • GETList AI Gateway routing policies/api/v2/policies?user_id=3fa85f64-5717-4562-b3fc-2c963f66afa6List all routing policy documents for the organization. Pass user_id to filter by user scope.
  • POSTCreate or replace an AI Gateway routing policy/api/v2/policies?user_id=3fa85f64-5717-4562-b3fc-2c963f66afa6Create or replace the routing policy document for an inbound pattern. Pass user_id to scope the policy to a user.
  • GETGet an AI Gateway routing policy/api/v2/policies/:inbound?user_id=3fa85f64-5717-4562-b3fc-2c963f66afa6Get the routing policy document for a specific inbound pattern.
  • DELETEDelete an AI Gateway routing policy/api/v2/policies/:inbound?user_id=3fa85f64-5717-4562-b3fc-2c963f66afa6Delete the routing policy document for a specific inbound pattern.
  • GETList models available from a provider integration/api/v2/provider-models?integration_type=openai&integration_account_id=account-123&project_id=my-project&location=us-central1&bedrock_region=us-east-1&foundry_resource_id=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ai/providers/Microsoft.CognitiveServices/accounts/my-foundryList live models available to a provider integration account that supports model discovery.
  • GETList AI Gateway providers/api/v2/providersList the model providers connected to the organization. Credentials stay in each provider's integration account and are never returned. Requires…
  • POSTCreate an AI Gateway provider/api/v2/providersCreating a provider requires ai_gateway_config_write. No provider View check applies before creation. Create a provider and its initial model catalog. All…
  • GETGet an AI Gateway provider/api/v2/providers/:idGet a provider by ID, including its routing slug, integration account, and cost multiplier. Credentials stay in the integration account and are never…
  • DELETEDelete an AI Gateway provider/api/v2/providers/:id?force=falseRequires ai_gateway_config_write and provider View/Edit. Models and pricing inherit provider access. Every affected route and policy membership requires the…
  • PATCHUpdate an AI Gateway provider/api/v2/providers/:idUpdate a provider's display name or cost multiplier. Provider type, integration settings, and slug are immutable. Requires ai_gateway_config_write and…
  • GETList models for an AI Gateway provider/api/v2/providers/:provider_id/modelsList all model catalog entries for a provider. Requires ai_gateway_config_read and provider View. Catalog and pricing metadata inherit provider access. Lists…
  • POSTAdd a model to an AI Gateway provider/api/v2/providers/:provider_id/modelsRequires ai_gateway_config_write and provider Edit. Models and pricing inherit provider access. Add a manually managed model catalog entry to a provider.…
  • POSTAdd multiple models to an AI Gateway provider/api/v2/providers/:provider_id/models/bulkRequires ai_gateway_config_write and provider Edit. Models and pricing inherit provider access. Add multiple manually managed model catalog entries to a…
  • DELETEDelete a model from an AI Gateway provider/api/v2/providers/:provider_id/models/:canonicalRequires ai_gateway_config_write and provider Edit. Models and pricing inherit provider access. Delete a manually managed model catalog entry by its canonical…
  • PATCHUpdate a model for an AI Gateway provider/api/v2/providers/:provider_id/models/:canonicalUpdate a manually managed model catalog entry. Discovered entries are read-only. Requires ai_gateway_config_write and provider Edit. Models and pricing…
  • GETGet a model pricing override/api/v2/providers/:provider_id/models/:canonical/pricingGet a custom provider model's pricing override and effective pricing source. Requires ai_gateway_config_read and provider View. Catalog and pricing metadata…
  • PUTSet a model pricing override/api/v2/providers/:provider_id/models/:canonical/pricingSet a custom provider model's pricing override. Requires ai_gateway_config_write and provider Edit. Models and pricing inherit provider access.
  • DELETEDelete a model pricing override/api/v2/providers/:provider_id/models/:canonical/pricingClear a custom provider model's pricing override. Requires ai_gateway_config_write and provider Edit. Models and pricing inherit provider access.
  • GETList AI Gateway rate limits/api/v2/rate-limitsList the organization's AI Gateway rate limits.
  • POSTCreate an AI Gateway rate limit/api/v2/rate-limitsCreate a rate limit. All requests matching its scope share one allowance, unless a selector makes it a template, which gives each matched user, Team, or value…
  • GETList AI Gateway rate limit counter summaries/api/v2/rate-limits/instances/summaryAggregate the counters of every template rate limit in the organization in one call. The response has one summary per template, in the same order as the rate…
  • GETGet AI Gateway rate limit usage/api/v2/rate-limits/usageGet live usage for the organization's rate limits. Returns requests and tokens counted in the rolling one-minute window and requests limited in the last 15…
  • GETGet an AI Gateway rate limit/api/v2/rate-limits/:idGet a rate limit by ID, including its scope, per-minute request and token limits, and whether it is enabled.
  • DELETEArchive an AI Gateway rate limit/api/v2/rate-limits/:idArchive a rate limit by ID. An archived rate limit no longer appears in lists or lookups, and its alert monitor is deleted.
  • PATCHUpdate an AI Gateway rate limit/api/v2/rate-limits/:idUpdate a rate limit. Only the attributes sent are changed, and changes never reset current usage. Scope stays editable, except on a template rate limit, whose…
  • GETList AI Gateway rate limit counters/api/v2/rate-limits/:id/instances?split_dim=user_id=11111111-1111-1111-1111-111111111111&sort=utilization_desc&limit=50&offset=0List the hot counters of a template rate limit, one per matched user, Team, or value, with their live usage. The list includes only counters that, in the last…
  • GETGet an AI Gateway rate limit counter summary/api/v2/rate-limits/:id/instances/summary?split_dim=user_id=11111111-1111-1111-1111-111111111111Aggregate a template rate limit's hot counters, including how many there are, how many are near or at their limit, and the fullest counter's utilization. Hot…
  • GETList AI Gateway routing rules/api/v2/routing-rulesList the organization's routing rules that the caller has View access to. Requires ai_gateway_config_read. Hidden route references are omitted from nested…
  • PUTUpdate an AI Gateway routing rule/api/v2/routing-rules?slug=codingUpdate a route with ai_gateway_config_write and route View/Edit. The slug is immutable; data capture is managed independently. Omitting tiers preserves the…
  • POSTCreate an AI Gateway routing rule/api/v2/routing-rulesCreate an organization-owned route with ai_gateway_config_write. New provider/model and route references require View. New routes use standard unrestricted…
  • DELETEDelete an AI Gateway routing rule/api/v2/routing-rules?slug=coding&force=falseDelete a route with ai_gateway_config_write and route View/Edit. Every affected route and policy membership requires the corresponding Edit permission. The…
  • GETGet an AI Gateway routing rule/api/v2/routing-rules/get?slug=codingGet a routing rule by slug with ai_gateway_config_read and route View. Hidden and missing routes both return 404. Hidden target identities are omitted;…

AI Guard

  • POSTEvaluate an AI Guard request/api/v2/ai-guard/evaluateAnalyzes a conversation for security threats such as prompt injection, jailbreak attempts, and other AI-specific attacks. Returns an action recommendation…

API Management

  • GETList APIs/api/v2/apicatalog/api?query=payments&page[limit]=20&page[offset]=0Deprecated. List APIs and their IDs.
  • DELETEDelete an API/api/v2/apicatalog/api/:idDeprecated. Delete a specific API by ID.
  • GETGet an API/api/v2/apicatalog/api/:id/openapiDeprecated. Retrieve information about a specific API in OpenAPI format file.
  • PUTUpdate an API/api/v2/apicatalog/api/:id/openapiDeprecated. Update information about a specific API. The given content will replace all API content of the given ID. The ID is returned by the create API, or…
  • POSTCreate a new API/api/v2/apicatalog/openapiDeprecated. Create a new API from the OpenAPI specification given. See the API Catalog documentation for additional information about the possible metadata.…

APM

  • GETGet service list/api/v2/apm/services?filter[env]=string

APM Retention Filters

  • GETList all APM retention filters/api/v2/apm/config/retention-filtersGet the list of APM retention filters.
  • POSTCreate a retention filter/api/v2/apm/config/retention-filtersCreate a retention filter to index spans in your organization. Returns the retention filter definition when the request is successful. Default filters with…
  • PUTRe-order retention filters/api/v2/apm/config/retention-filters-execution-orderRe-order the execution order of retention filters.
  • GETGet a given APM retention filter/api/v2/apm/config/retention-filters/:filter_idGet an APM retention filter.
  • PUTUpdate a retention filter/api/v2/apm/config/retention-filters/:filter_idUpdate a retention filter from your organization. Default filters (filters with types spans-errors-sampling-processor and spans-appsec-sampling-processor)…
  • DELETEDelete a retention filter/api/v2/apm/config/retention-filters/:filter_idDelete a specific retention filter from your organization. Default filters with types spans-errors-sampling-processor and spans-appsec-sampling-processor…

APM Trace

  • GETGet a pruned trace by ID/api/v2/pruned_trace/:trace_id?expand_span_id=9876543210987654321&time_hint=1716800000&force_source=driveline&include_path=service:web-store&tag_include=^http\.&tag_exclude=^_dd\.&only_service_entry_spans=falseRetrieve a pruned, hierarchical view of an APM trace by its trace ID. The trace is summarized as a tree of spans rooted at the trace root and reduced in size…
  • GETGet a trace by ID/api/v2/trace/:trace_id?include_fields=http.status_code,error.messageRetrieve a full APM trace by its trace ID, including every span in the trace. Traces are returned from live storage when available and fall back to…

AWS Integration

  • GETList all AWS integrations/api/v2/integration/aws/accounts?aws_account_id=123456789012Get a list of AWS Account Integration Configs.
  • POSTCreate an AWS integration/api/v2/integration/aws/accountsCreate a new AWS Account Integration Config.
  • GETGet an AWS integration by config ID/api/v2/integration/aws/accounts/:aws_account_config_idGet an AWS Account Integration Config by config ID.
  • DELETEDelete an AWS integration/api/v2/integration/aws/accounts/:aws_account_config_idDelete an AWS Account Integration Config by config ID.
  • PATCHUpdate an AWS integration/api/v2/integration/aws/accounts/:aws_account_config_idUpdate an AWS Account Integration Config by config ID.
  • GETGet AWS CCM config/api/v2/integration/aws/accounts/:aws_account_config_id/ccm_configGet the Cloud Cost Management config for an AWS Account Integration Config using Cost and Usage Report (CUR) 2.0 by config ID.
  • POSTCreate AWS CCM config/api/v2/integration/aws/accounts/:aws_account_config_id/ccm_configCreate the Cloud Cost Management config for an AWS Account Integration Config using Cost and Usage Report (CUR) 2.0 by config ID.
  • DELETEDelete AWS CCM config/api/v2/integration/aws/accounts/:aws_account_config_id/ccm_configDelete the Cloud Cost Management config for an AWS Account Integration Config using Cost and Usage Report (CUR) 2.0 by config ID.
  • PATCHUpdate AWS CCM config/api/v2/integration/aws/accounts/:aws_account_config_id/ccm_configUpdate the Cloud Cost Management config for an AWS Account Integration Config using Cost and Usage Report (CUR) 2.0 by config ID.
  • GETGet AWS metric name filter preview/api/v2/integration/aws/accounts/:aws_account_config_id/metric_name_filter_previewPreview which collected CloudWatch metrics would be filtered by the account's saved metric name filters.
  • POSTPreview AWS metric name filter/api/v2/integration/aws/accounts/:aws_account_config_id/metric_name_filter_previewPreview which collected CloudWatch metrics would be filtered by the supplied metric name filters. The filters are not persisted.
  • GETList available namespaces/api/v2/integration/aws/available_namespacesGet a list of available AWS CloudWatch namespaces that can send metrics to Datadog.
  • GETGet all Amazon EventBridge sources/api/v2/integration/aws/event_bridgeGet all Amazon EventBridge sources.
  • POSTCreate an Amazon EventBridge source/api/v2/integration/aws/event_bridgeCreate an Amazon EventBridge source.
  • DELETEDelete an Amazon EventBridge source/api/v2/integration/aws/event_bridgeDelete an Amazon EventBridge source.
  • POSTGenerate a new external ID/api/v2/integration/aws/generate_new_external_idGenerate a new external ID for AWS role-based authentication.
  • GETGet AWS integration IAM permissions/api/v2/integration/aws/iam_permissionsGet all AWS IAM permissions required for the AWS integration.
  • GETGet resource collection IAM permissions/api/v2/integration/aws/iam_permissions/resource_collectionGet all resource collection AWS IAM permissions required for the AWS integration.
  • GETGet AWS integration standard IAM permissions/api/v2/integration/aws/iam_permissions/standardGet all standard AWS IAM permissions required for the AWS integration.
  • POSTValidate AWS CCM config/api/v2/integration/aws/validate_ccm_configValidate a Cloud Cost Management config for an AWS account using Cost and Usage Report (CUR) 2.0 against Datadog's ingest requirements without persisting it.

AWS Logs Integration

  • GETGet list of AWS log ready services/api/v2/integration/aws/logs/servicesGet a list of AWS services that can send logs to Datadog.

Action Connection

  • GETList App Key Registrations/api/v2/actions/app_key_registrations?page[size]=0&page[number]=0List App Key Registrations
  • GETGet an existing App Key Registration/api/v2/actions/app_key_registrations/:app_key_idGet an existing App Key Registration
  • PUTRegister a new App Key/api/v2/actions/app_key_registrations/:app_key_idRegister a new App Key
  • DELETEUnregister an App Key/api/v2/actions/app_key_registrations/:app_key_idUnregister an App Key
  • POSTCreate a new Action Connection/api/v2/actions/connectionsCreate a new Action Connection. This API requires a registered application key.
  • GETGet an existing Action Connection/api/v2/actions/connections/:connection_idGet an existing Action Connection. This API requires a registered application key.
  • DELETEDelete an existing Action Connection/api/v2/actions/connections/:connection_idDelete an existing Action Connection. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.
  • PATCHUpdate an existing Action Connection/api/v2/actions/connections/:connection_idUpdate an existing Action Connection. This API requires a registered application key.

Actions Datastores

  • GETList datastores/api/v2/actions-datastoresLists all datastores for the organization.
  • POSTCreate datastore/api/v2/actions-datastoresCreates a new datastore.
  • GETGet datastore/api/v2/actions-datastores/:datastore_idRetrieves a specific datastore by its ID.
  • DELETEDelete datastore/api/v2/actions-datastores/:datastore_idDeletes a datastore by its unique identifier.
  • PATCHUpdate datastore/api/v2/actions-datastores/:datastore_idUpdates an existing datastore's attributes.
  • GETList datastore items/api/v2/actions-datastores/:datastore_id/items?filter=string&item_key=string&page[limit]=1&page[offset]=0&sort=stringLists items from a datastore. You can filter the results by specifying either an item key or a filter query parameter, but not both at the same time. Supports…
  • DELETEDelete datastore item/api/v2/actions-datastores/:datastore_id/itemsDeletes an item from a datastore by its key.
  • PATCHUpdate datastore item/api/v2/actions-datastores/:datastore_id/itemsPartially updates an item in a datastore by its key.
  • POSTBulk write datastore items/api/v2/actions-datastores/:datastore_id/items/bulkCreates or replaces multiple items in a datastore by their keys in a single operation.
  • DELETEBulk delete datastore items/api/v2/actions-datastores/:datastore_id/items/bulkDeletes multiple items from a datastore by their keys in a single operation.

Agent Health

  • GETList active Agent Health issues/api/v2/agenthealth/hosts/:resource_id/issues?agent_type=nodeReturns the active Agent Health issues for a node Agent or Cluster Agent resource.
  • GETList Agent Health issues/api/v2/agenthealth/issues?page[size]=25&page[number]=0&filter[severity]=high,medium&filter[category]=configuration&filter[issue_type]=invalid_config&filter[resource_kind]=host,deployment&filter[resource_id]=my-hostnameList Agent Health issues across your organization. Only open issues are returned. Returns 403 if you lack the hosts_read permission. Results use a stable…
  • GETGet an Agent Health issue/api/v2/agenthealth/issues/:issue_idGet an Agent Health issue and its available remediation in your organization. Only open issues are returned. The remediation attribute is omitted when the…

Agent Observability

  • GETList custom evaluator configurations/api/unstable/llm-obs/config/evaluators/customList all custom Agent Observability evaluator configurations for the organization.
  • GETGet a custom evaluator configuration/api/unstable/llm-obs/config/evaluators/custom/:eval_nameRetrieve a custom Agent Observability evaluator configuration by its name.
  • PUTCreate or update a custom evaluator configuration/api/unstable/llm-obs/config/evaluators/custom/:eval_nameCreate or update a custom Agent Observability evaluator configuration by its name.
  • DELETEDelete a custom evaluator configuration/api/unstable/llm-obs/config/evaluators/custom/:eval_nameDelete a custom Agent Observability evaluator configuration by its name.
  • GETGet annotated interactions by content IDs/api/v2/llm-obs/v1/annotated-interactions?contentIds=string&offset=0&limit=100Returns annotated interactions across all annotation queues for the given content IDs. Results include queue metadata (ID and name) for each interaction.
  • GETList Agent Observability annotation queues/api/v2/llm-obs/v1/annotation-queues?projectId=string&queueIds=stringList annotation queues. Optionally filter by project ID or queue IDs. These parameters are mutually exclusive. If neither is provided, all queues in the…
  • POSTCreate an Agent Observability annotation queue/api/v2/llm-obs/v1/annotation-queuesCreate an annotation queue. The name and project_id fields are required. An optional annotation_schema can be provided to define the labels for the queue.…
  • DELETEDelete an Agent Observability annotation queue/api/v2/llm-obs/v1/annotation-queues/:queue_idDelete an annotation queue by its ID.
  • PATCHUpdate an Agent Observability annotation queue/api/v2/llm-obs/v1/annotation-queues/:queue_idPartially update an annotation queue. The name, description, annotation_schema, reviewer_emails, restrict_to_reviewers, and restrict_to_assignees fields can…
  • GETGet annotated queue interactions/api/v2/llm-obs/v1/annotation-queues/:queue_id/annotated-interactionsRetrieve all interactions (traces and sessions) and their annotations for a given annotation queue.
  • GETGet an annotated queue interaction/api/v2/llm-obs/v1/annotation-queues/:queue_id/annotated-interactions/:interaction_id?limit=10&cursor=stringRetrieve an interaction, its annotations, and a page of related events from an annotation queue.
  • POSTCreate or update annotations/api/v2/llm-obs/v1/annotation-queues/:queue_id/annotationsCreate or update annotations on interactions in a queue. Each annotation is matched by interaction_id and the requesting user's identity. Use the optional…
  • POSTDelete annotations/api/v2/llm-obs/v1/annotation-queues/:queue_id/annotations/deleteDelete one or more annotations from an annotation queue.
  • POSTAdd annotation queue interactions/api/v2/llm-obs/v1/annotation-queues/:queue_id/interactionsAdd one or more interactions to an annotation queue. At least one interaction must be provided. Each interaction has a type: trace, experiment_trace, session:…
  • POSTDelete annotation queue interactions/api/v2/llm-obs/v1/annotation-queues/:queue_id/interactions/deleteDelete one or more interactions from an annotation queue.
  • GETGet annotation queue label schema/api/v2/llm-obs/v1/annotation-queues/:queue_id/label-schemaRetrieve the label schema for a given annotation queue.
  • PUTUpdate annotation queue label schema/api/v2/llm-obs/v1/annotation-queues/:queue_id/label-schemaCreate or replace the label schema for a given annotation queue. The label schema defines the labels annotators can apply to interactions in the queue. Label…
  • POSTAggregate Agent Observability experimentation/api/v2/llm-obs/v1/experimentation/analyticsExecute an analytics aggregation over Agent Observability experimentation data. Use this endpoint to compute metrics (for example average eval scores) grouped…
  • POSTSearch Agent Observability experimentation/api/v2/llm-obs/v1/experimentation/searchSearch across Agent Observability experimentation entities — projects, datasets, dataset records, experiments, and experiment runs — using cursor-based…
  • POSTSimple search experimentation entities/api/v2/llm-obs/v1/experimentation/simple-searchSearch across Agent Observability experimentation entities using offset-based (page-number) pagination. Use this endpoint when you need total page count or…
  • GETList Agent Observability experiments/api/v2/llm-obs/v1/experiments?filter[project_id]=string&filter[dataset_id]=string&filter[id]=string&filter[name]=string&filter[experiment]=string&filter[metadata]=string&filter[parent_experiment_id]=string&filter[is_deleted]=true&include[user_data]=true&include[dataset_names]=true&page[cursor]=string&page[limit]=0List all Agent Observability experiments sorted by creation date, newest first.
  • POSTCreate an Agent Observability experiment/api/v2/llm-obs/v1/experimentsCreate a new Agent Observability experiment.
  • POSTDelete Agent Observability experiments/api/v2/llm-obs/v1/experiments/deleteDelete one or more Agent Observability experiments.
  • PATCHUpdate an Agent Observability experiment/api/v2/llm-obs/v1/experiments/:experiment_idPartially update an existing Agent Observability experiment.
  • GETList Agent Observability experiment spans (v1)/api/v2/llm-obs/v1/experiments/:experiment_id/eventsDeprecated. Retrieve spans with their evaluation metrics for a given experiment. Returns spans only, with no summary metrics and no pagination. Deprecated in…
  • POSTPush events for an Agent Observability experiment/api/v2/llm-obs/v1/experiments/:experiment_id/eventsPush spans and metrics for an Agent Observability experiment.
  • GETList LLM integration accounts/api/v2/llm-obs/v1/integrations/:integration/accountsRetrieve the list of configured accounts for the specified LLM provider integration.
  • POSTRun an LLM inference/api/v2/llm-obs/v1/integrations/:integration/:account_id/inferenceRun an LLM inference request through the specified integration and account, returning the model response and token usage.
  • GETList LLM integration models/api/v2/llm-obs/v1/integrations/:integration/:account_id/modelsRetrieve the list of models available for the specified LLM provider integration and account.
  • GETList Agent Observability projects/api/v2/llm-obs/v1/projects?filter[id]=string&filter[name]=string&page[cursor]=string&page[limit]=0List all Agent Observability projects sorted by creation date, newest first.
  • POSTCreate an Agent Observability project/api/v2/llm-obs/v1/projectsCreate a new Agent Observability project. Returns the existing project if a name conflict occurs.
  • POSTDelete Agent Observability projects/api/v2/llm-obs/v1/projects/deleteDelete one or more Agent Observability projects.
  • PATCHUpdate an Agent Observability project/api/v2/llm-obs/v1/projects/:project_idPartially update an existing Agent Observability project.
  • GETList Agent Observability prompts/api/v2/llm-obs/v1/prompts?filter[prompt_id]=customer-support-assistantList all Agent Observability prompts in the prompt registry for the organization.
  • POSTCreate an Agent Observability prompt/api/v2/llm-obs/v1/promptsCreate a new prompt (and its first version) in the Agent Observability prompt registry. > Preview: Prompt composition is available in Preview. To request…
  • GETGet an Agent Observability prompt/api/v2/llm-obs/v1/prompts/:prompt_id?label=stringGet the latest version of an Agent Observability prompt by prompt ID.
  • DELETEDelete an Agent Observability prompt/api/v2/llm-obs/v1/prompts/:prompt_idSoft-delete an Agent Observability prompt. The prompt's version rows are retained, but they are no longer accessible through the public prompt registry…
  • PATCHUpdate an Agent Observability prompt/api/v2/llm-obs/v1/prompts/:prompt_idUpdate the title, the description, or both, for an Agent Observability prompt.
  • GETList versions of an Agent Observability prompt/api/v2/llm-obs/v1/prompts/:prompt_id/versionsList all versions of an Agent Observability prompt, ordered newest to oldest. If the prompt does not exist, is not registered, or is archived, the response…
  • POSTCreate a new Agent Observability prompt version/api/v2/llm-obs/v1/prompts/:prompt_id/versionsCreate a new version of an existing Agent Observability prompt. > Preview: Prompt composition is available in Preview. To request access, contact Datadog…
  • GETGet a specific Agent Observability prompt version/api/v2/llm-obs/v1/prompts/:prompt_id/versions/:versionGet the full template and configuration of a single, specific version of an Agent Observability prompt.
  • PATCHUpdate an Agent Observability prompt version/api/v2/llm-obs/v1/prompts/:prompt_id/versions/:versionUpdate the description, the feature-flag environments, or both, for a specific version of an Agent Observability prompt.
  • GETList Agent Observability spans/api/v2/llm-obs/v1/spans/events?filter[from]=now-900s&filter[to]=now&filter[query]=@session_id:abc123def456&filter[span_id]=string&filter[trace_id]=string&filter[span_kind]=string&filter[span_name]=string&filter[ml_app]=string&page[limit]=0&page[cursor]=string&sort=string&include_attachments=trueList Agent Observability spans matching the specified filters.
  • POSTSearch Agent Observability spans/api/v2/llm-obs/v1/spans/events/searchSearch Agent Observability spans using structured filters in the request body.
  • GETList patterns clustered points/api/v2/llm-obs/v1/topic-discovery-clustered-points?topic_id=5c1fae90-2b6d-4e3a-9f12-7a0c4d8e6b21&page_size=0&page_token=stringList the data points grouped into a topic. For a parent topic, points from all of its leaf topics are returned.
  • GETList patterns configurations/api/v2/llm-obs/v1/topic-discovery-configsList all patterns configurations for the organization.
  • PUTCreate or update a patterns configuration/api/v2/llm-obs/v1/topic-discovery-configsCreate a new patterns configuration, or update an existing one when a configuration ID is provided.
  • GETGet a patterns configuration/api/v2/llm-obs/v1/topic-discovery-configs/latestRetrieve the patterns configuration for the organization.
  • DELETEDelete a patterns configuration/api/v2/llm-obs/v1/topic-discovery-configs/:config_idDelete a patterns configuration by its ID.
  • GETList patterns runs/api/v2/llm-obs/v1/topic-discovery-runs?config_id=a7c8d9e0-1234-5678-9abc-def012345678List the completed patterns runs for a configuration.
  • POSTTrigger a patterns run/api/v2/llm-obs/v1/topic-discovery-runsStart a patterns run for a given configuration. The run executes asynchronously.
  • GETGet patterns run status/api/v2/llm-obs/v1/topic-discovery-runs/status?config_id=a7c8d9e0-1234-5678-9abc-def012345678Retrieve the status and step-by-step progress of the current or most recent patterns run for a configuration.
  • GETList patterns templates/api/v2/llm-obs/v1/topic-discovery-templatesList all enabled patterns templates.
  • GETList patterns topics/api/v2/llm-obs/v1/topic-discovery-topics?config_id=a7c8d9e0-1234-5678-9abc-def012345678&run_id=3fd6b5e0-8910-4b1c-a7d0-5b84de329012List the topics discovered by a patterns run. When no run is specified, the most recent completed run is used.
  • GETList patterns topics with clustered points/api/v2/llm-obs/v1/topic-discovery-topics/with-cluster-points?config_id=a7c8d9e0-1234-5678-9abc-def012345678&run_id=3fd6b5e0-8910-4b1c-a7d0-5b84de329012&include_metrics=trueList the topics discovered by a patterns run, with the clustered points attached inline to each leaf topic. When no run is specified, the most recent…
  • GETList Agent Observability datasets/api/v2/llm-obs/v1/:project_id/datasets?filter[name]=string&filter[id]=string&page[cursor]=string&page[limit]=0List all Agent Observability datasets for a project, sorted by creation date, newest first.
  • POSTCreate an Agent Observability dataset/api/v2/llm-obs/v1/:project_id/datasetsCreate a new Agent Observability dataset within the specified project.
  • POSTDelete Agent Observability datasets/api/v2/llm-obs/v1/:project_id/datasets/deleteDelete one or more Agent Observability datasets within the specified project.
  • PATCHUpdate an Agent Observability dataset/api/v2/llm-obs/v1/:project_id/datasets/:dataset_idPartially update an existing Agent Observability dataset within the specified project.
  • POSTBatch update Agent Observability dataset records/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/batch_updateInsert, update, and delete records in a single dataset operation. By default, a new dataset version is created when the batch is applied.
  • POSTClone an Agent Observability dataset/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/cloneClone a dataset, copying its current records into a new dataset within the same project.
  • GETGet Agent Observability dataset draft state/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/draft_stateRetrieve the draft state of a dataset, including whether it is currently locked for editing and which user holds the lock.
  • PATCHLock Agent Observability dataset draft state/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/draft_state/lockAcquire the draft lock on a dataset for the calling user. The lock prevents other users from concurrently editing the dataset draft.
  • PATCHUnlock Agent Observability dataset draft state/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/draft_state/unlockRelease the draft lock on a dataset held by the calling user, allowing other users to edit the dataset draft.
  • GETExport an Agent Observability dataset/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/export?format=csv&version=0Download the contents of a dataset as a CSV file. The download is streamed and includes one row per dataset record.
  • GETList Agent Observability dataset records/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/records?filter[version]=0&page[cursor]=string&page[limit]=0List all records in an Agent Observability dataset, sorted by creation date, newest first.
  • POSTAppend records to an Agent Observability dataset/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/recordsAppend one or more records to an Agent Observability dataset.
  • PATCHUpdate Agent Observability dataset records/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/recordsUpdate one or more existing records in an Agent Observability dataset.
  • POSTDelete Agent Observability dataset records/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/records/deleteDelete one or more records from an Agent Observability dataset.
  • POSTRestore an Agent Observability dataset version/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/restoreRestore a dataset to a previous version. The dataset's current version is bumped, and its records are replaced with the records from the specified prior…
  • GETList Agent Observability dataset versions/api/v2/llm-obs/v1/:project_id/datasets/:dataset_id/versionsList the active versions of a dataset. A version is created each time a dataset is referenced by an experiment run.
  • GETList Agent Observability experiment events (v2)/api/v2/llm-obs/v2/experiments/:experiment_id/eventsDeprecated. Retrieve spans and experiment-level summary metrics for a given experiment. Returns the full events payload without pagination. Deprecated: use…
  • POSTUpload records to an Agent Observability dataset/api/v2/llm-obs/v2/:project_id/datasets/:dataset_id/records/upload?deduplicate=false&overwrite=true&tags=string&include[user_data]=trueUpload records to a dataset from a file. The request is a multipart/form-data upload containing a single file part. Currently only CSV is supported. The CSV…
  • GETList events for an Agent Observability experiment/api/v2/llm-obs/v3/experiments/:experiment_id/events?page[limit]=5000&page[cursor]=stringRetrieve spans and experiment-level summary metrics for a given experiment with cursor-based pagination.

Agentless Scanning

  • GETList AWS scan options/api/v2/agentless_scanning/accounts/awsFetches the scan options configured for AWS accounts.
  • POSTCreate AWS scan options/api/v2/agentless_scanning/accounts/awsActivate Agentless scan options for an AWS account.
  • GETGet AWS scan options/api/v2/agentless_scanning/accounts/aws/:account_idFetches the Agentless scan options for an activated account.
  • DELETEDelete AWS scan options/api/v2/agentless_scanning/accounts/aws/:account_idDelete Agentless scan options for an AWS account.
  • PATCHUpdate AWS scan options/api/v2/agentless_scanning/accounts/aws/:account_idUpdate the Agentless scan options for an activated account.
  • GETList Azure scan options/api/v2/agentless_scanning/accounts/azureFetches the scan options configured for Azure accounts.
  • POSTCreate Azure scan options/api/v2/agentless_scanning/accounts/azureActivate Agentless scan options for an Azure subscription.
  • GETGet Azure scan options/api/v2/agentless_scanning/accounts/azure/:subscription_idFetches the Agentless scan options for an activated subscription.
  • DELETEDelete Azure scan options/api/v2/agentless_scanning/accounts/azure/:subscription_idDelete Agentless scan options for an Azure subscription.
  • PATCHUpdate Azure scan options/api/v2/agentless_scanning/accounts/azure/:subscription_idUpdate the Agentless scan options for an activated subscription.
  • GETList GCP scan options/api/v2/agentless_scanning/accounts/gcpFetches the scan options configured for all GCP projects.
  • POSTCreate GCP scan options/api/v2/agentless_scanning/accounts/gcpActivate Agentless scan options for a GCP project.
  • GETGet GCP scan options/api/v2/agentless_scanning/accounts/gcp/:project_idFetches the Agentless scan options for an activated GCP project.
  • DELETEDelete GCP scan options/api/v2/agentless_scanning/accounts/gcp/:project_idDelete Agentless scan options for a GCP project.
  • PATCHUpdate GCP scan options/api/v2/agentless_scanning/accounts/gcp/:project_idUpdate the Agentless scan options for an activated GCP project.
  • GETList AWS on demand tasks/api/v2/agentless_scanning/ondemand/awsFetches the most recent 1000 AWS on demand tasks.
  • POSTCreate AWS on demand task/api/v2/agentless_scanning/ondemand/awsTrigger the scan of an AWS resource with a high priority. Agentless scanning must be activated for the AWS account containing the resource to scan.
  • GETGet AWS on demand task/api/v2/agentless_scanning/ondemand/aws/:task_idFetch the data of a specific on demand task.

Annotations

  • GETList annotations/api/v2/annotation?page_id=dashboard:abc-def-xyz&start_time=1704067200000&end_time=1704153600000&widget_id=stringReturns a flat list of annotations matching the given page, time window, and optional widget filter.
  • POSTCreate an annotation/api/v2/annotationCreates a new annotation on a dashboard or notebook page. Valid color values: gray, blue, purple, green, yellow, red. Valid type values: pointInTime (marks a…
  • GETGet annotations for a page/api/v2/annotation/page/:page_id?start_time=1704067200000&end_time=1704153600000Returns all annotations on a specific page for a given time window, grouped by widget. Unlike ListAnnotations, this endpoint returns a single structured…
  • PUTUpdate an annotation/api/v2/annotation/:annotation_idUpdates an existing annotation. Valid color values: gray, blue, purple, green, yellow, red. Valid type values: pointInTime (marks a single moment) or…
  • DELETEDelete an annotation/api/v2/annotation/:annotation_idDeletes an existing annotation by ID. Returns 204 No Content if the annotation does not exist (idempotent).

App Builder

  • GETList Apps/api/v2/app-builder/apps?limit=0&page=0&filter[user_name]=string&filter[user_uuid]=65bb1f25-52e1-4510-9f8d-22d1516ed693&filter[name]=string&filter[query]=string&filter[deployed]=true&filter[tags]=string&filter[favorite]=true&filter[self_service]=true&sort=-created_atList all apps, with optional filters and sorting. This endpoint is paginated. Only basic app information such as the app ID, name, and description is returned…
  • POSTCreate App/api/v2/app-builder/appsCreate a new app, returning the app ID. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.
  • DELETEDelete Multiple Apps/api/v2/app-builder/appsDelete multiple apps in a single request from a list of app IDs. This API requires a registered application key. Alternatively, you can configure these…
  • GETGet App/api/v2/app-builder/apps/:app_id?version=stringGet the full definition of an app. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.
  • DELETEDelete App/api/v2/app-builder/apps/:app_idDelete a single app. This API requires a registered application key. Alternatively, you can configure these permissions in the UI.
  • PATCHUpdate App/api/v2/app-builder/apps/:app_idUpdate an existing app. This creates a new version of the app. This API requires a registered application key. Alternatively, you can configure these…
  • POSTPublish App/api/v2/app-builder/apps/:app_id/deploymentPublish an app for use by other users. To ensure the app is accessible to the correct users, you also need to set a Restriction Policy on the app if a policy…
  • DELETEUnpublish App/api/v2/app-builder/apps/:app_id/deploymentUnpublish an app, removing the live version of the app. Unpublishing creates a new instance of a deployment object on the app, with a nil app_version_id…
  • PATCHUpdate App Favorite Status/api/v2/app-builder/apps/:app_id/favoriteAdd or remove an app from the current user's favorites. Favorited apps can be filtered for using the filter[favorite] query parameter on the List Apps endpoint.
  • PATCHUpdate App Protection Level/api/v2/app-builder/apps/:app_id/protection-levelUpdate the publication protection level of an app. When set to approval_required, future publishes must go through an approval workflow before going live.
  • POSTCreate Publish Request/api/v2/app-builder/apps/:app_id/publish-requestCreate a publish request to ask for approval to publish an app whose protection level is approval_required. Publishing happens automatically once the request…
  • POSTRevert App/api/v2/app-builder/apps/:app_id/revert?version=2Revert an app to a previous version. The version to revert to is selected through the version query parameter. The reverted version becomes the new latest…
  • PATCHUpdate App Self-Service Status/api/v2/app-builder/apps/:app_id/self-serviceEnable or disable self-service for an app. Self-service apps can be discovered and run by users in your organization without explicit access being granted.
  • PATCHUpdate App Tags/api/v2/app-builder/apps/:app_id/tagsReplace the tags on an app. The provided list overwrites the existing tags entirely; tags not present in the request body are removed.
  • PATCHName App Version/api/v2/app-builder/apps/:app_id/version-name?version=3Assign a human-readable name to a specific version of an app. The version is selected through the version query parameter.
  • GETList App Versions/api/v2/app-builder/apps/:app_id/versions?limit=0&page=0List the versions of an app. This endpoint is paginated.
  • GETGet Blueprint/api/v2/app-builder/blueprint/:blueprint_idRetrieve an app blueprint by its ID.
  • GETList Blueprints/api/v2/app-builder/blueprints?limit=0&page=0List available app blueprints.
  • GETGet Blueprints by Integration ID/api/v2/app-builder/blueprints/integration-id/:integration_idList app blueprints associated with a specific integration ID.
  • GETGet Blueprints by Slugs/api/v2/app-builder/blueprints/slugs/:slugsRetrieve app blueprints by their slugs.
  • GETList Tags/api/v2/app-builder/tagsList all tags associated with the authenticated user's apps.

Application Security

  • GETList all WAF custom rules/api/v2/remote_config/products/asm/waf/custom_rulesRetrieve a list of WAF custom rule.
  • POSTCreate a WAF custom rule/api/v2/remote_config/products/asm/waf/custom_rulesCreate a new WAF custom rule with the given parameters.
  • GETGet a WAF custom rule/api/v2/remote_config/products/asm/waf/custom_rules/:custom_rule_idRetrieve a WAF custom rule by ID.
  • PUTUpdate a WAF Custom Rule/api/v2/remote_config/products/asm/waf/custom_rules/:custom_rule_idUpdate a specific WAF custom Rule. Returns the Custom Rule object when the request is successful.
  • DELETEDelete a WAF Custom Rule/api/v2/remote_config/products/asm/waf/custom_rules/:custom_rule_idDelete a specific WAF custom rule.
  • GETList all WAF exclusion filters/api/v2/remote_config/products/asm/waf/exclusion_filtersRetrieve a list of WAF exclusion filters.
  • POSTCreate a WAF exclusion filter/api/v2/remote_config/products/asm/waf/exclusion_filtersCreate a new WAF exclusion filter with the given parameters. A request matched by an exclusion filter will be ignored by the Application Security WAF product.…
  • GETGet a WAF exclusion filter/api/v2/remote_config/products/asm/waf/exclusion_filters/:exclusion_filter_idRetrieve a specific WAF exclusion filter using its identifier.
  • PUTUpdate a WAF exclusion filter/api/v2/remote_config/products/asm/waf/exclusion_filters/:exclusion_filter_idUpdate a specific WAF exclusion filter using its identifier. Returns the exclusion filter object when the request is successful.
  • DELETEDelete a WAF exclusion filter/api/v2/remote_config/products/asm/waf/exclusion_filters/:exclusion_filter_idDelete a specific WAF exclusion filter using its identifier.
  • GETList all WAF policies/api/v2/remote_config/products/asm/waf/policiesRetrieve a list of WAF policies.
  • POSTCreate a WAF Policy/api/v2/remote_config/products/asm/waf/policiesCreate a new WAF policy.
  • GETGet a WAF Policy/api/v2/remote_config/products/asm/waf/policies/:policy_idRetrieve a WAF policy by ID.
  • PUTUpdate a WAF Policy/api/v2/remote_config/products/asm/waf/policies/:policy_idUpdate a specific WAF policy. Returns the policy object when the request is successful.
  • DELETEDelete a WAF Policy/api/v2/remote_config/products/asm/waf/policies/:policy_idDelete a specific WAF policy.
  • GETGet Application Security details for a service/api/v2/security/asm/services/:service_filterRetrieve Application Security details for services matching the given name. Returns Application Security activation, compatibility, and product enablement…

Audit

  • GETGet a list of Audit Logs events/api/v2/audit/events?filter[query]=@type:session @application_id:xxxx&filter[from]=2019-01-02T09:42:36.320Z&filter[to]=2019-01-03T09:42:36.320Z&sort=timestamp&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==&page[limit]=25List endpoint returns events that match a Audit Logs search query. [Results are paginated][1]. Use this endpoint to see your latest Audit Logs events. [1]:…
  • POSTSearch Audit Logs events/api/v2/audit/events/searchList endpoint returns Audit Logs events that match an Audit search query. [Results are paginated][1]. Use this endpoint to build complex Audit Logs events…

AuthN Mappings

  • GETList all AuthN Mappings/api/v2/authn_mappings?page[size]=10&page[number]=0&sort=created_at&filter=string&resource_type=roleList all AuthN Mappings in the organization.
  • POSTCreate an AuthN Mapping/api/v2/authn_mappingsCreate an AuthN Mapping.
  • GETGet an AuthN Mapping by UUID/api/v2/authn_mappings/:authn_mapping_idGet an AuthN Mapping specified by the AuthN Mapping UUID.
  • DELETEDelete an AuthN Mapping/api/v2/authn_mappings/:authn_mapping_idDelete an AuthN Mapping specified by AuthN Mapping UUID.
  • PATCHEdit an AuthN Mapping/api/v2/authn_mappings/:authn_mapping_idEdit an AuthN Mapping.

Bits AI

  • GETList Bits AI investigations/api/v2/bits-ai/investigations?page[offset]=0&page[limit]=25&filter[monitor_id]=12345678List all Bits AI investigations for the organization.
  • POSTTrigger a Bits AI investigation/api/v2/bits-ai/investigationsTrigger a Bits AI investigation from a monitor alert or a general investigation. This endpoint requires the bits_investigations_write permission. When the…
  • GETGet a Bits AI investigation/api/v2/bits-ai/investigations/:idGet a specific Bits AI investigation by ID.

Bits Security Analyst

  • GETList Bits Security Analyst investigations/api/v2/security_monitoring/security_agent/investigations?filter[signal_id]=AQAAAaGNHjq4XzqcIQAAAABBWm8xY0wybUFBQmNYSjl1QUFBQUFBQUE&filter[title]=login&filter[from]=2026-10-01T00:00:00Z&filter[to]=2026-10-31T00:00:00Z&filter[verdict]=suspicious,malicious&filter[state]=completed&filter[rule_id]=abc-def-ghi&filter[rule_type]=log_detection&filter[signal_severity]=high,critical&filter[signal_source]=okta&filter[tags]=env:prod&filter[entity]=@usr.id:jane.doe&sort=-updated_at&page[number]=1&page[size]=25List Bits Security Analyst investigations. Without filter[signal_id], returns the latest investigation of each signal, filtered, sorted, and paginated. With…
  • GETCount Bits Security Analyst investigations/api/v2/security_monitoring/security_agent/investigations/count?field=verdict&filter[title]=login&filter[from]=2026-10-01T00:00:00Z&filter[to]=2026-10-31T00:00:00Z&filter[verdict]=suspicious,malicious&filter[rule_id]=abc-def-ghi&filter[rule_type]=log_detection&filter[signal_severity]=high,critical&filter[signal_source]=okta&filter[tags]=env:prod&filter[entity]=@usr.id:jane.doeCount completed Bits Security Analyst investigations by the values of one field. Buckets are sorted by ascending count. With field=entity or…
  • GETGet a Bits Security Analyst investigation/api/v2/security_monitoring/security_agent/investigations/:investigation_id?fields[investigations]=state,verdict,conclusionGet a Bits Security Analyst investigation by its ID, with its verdict, conclusion, evidence, steps, and response suggestions. While the investigation is…

CI Visibility GitHub Accounts

  • GETList GitHub CI Visibility status/api/v2/ci/github/accountsRetrieve the list of GitHub accounts (organizations or users) available to this Datadog organization through its GitHub App installation, along with each…
  • PATCHUpdate GitHub CI Visibility status/api/v2/ci/github/accountsEnable or disable CI Visibility for a GitHub account, one of its repositories, or both in the same request. The account (and, optionally, repository) are…

CI Visibility Logs

  • POSTSend CI job logshttps://http-intake.logs.datadoghq.com/api/v2/cilogsSend log lines for a CI job over HTTP. See the CI Visibility Pipelines API for submitting the associated pipeline and job events. A request can contain one…

CI Visibility Pipelines

  • POSTSend pipeline event/api/v2/ci/pipelineSend your pipeline event to your Datadog platform over HTTP. For details about how pipeline executions are modeled and what execution types we support, see…
  • POSTAggregate pipelines events/api/v2/ci/pipelines/analytics/aggregateUse this API endpoint to aggregate CI Visibility pipeline events into buckets of computed metrics and timeseries.
  • GETGet a list of pipelines events/api/v2/ci/pipelines/events?filter[query]=@ci.provider.name:github @ci.pipeline.name:Pull Request Labeler&filter[from]=2019-01-02T09:42:36.320Z&filter[to]=2019-01-03T09:42:36.320Z&sort=timestamp&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==&page[limit]=25List endpoint returns CI Visibility pipeline events that match a search query. Results are paginated similarly to logs. Use this endpoint to see your latest…
  • POSTSearch pipelines events/api/v2/ci/pipelines/events/searchList endpoint returns CI Visibility pipeline events that match a search query. Results are paginated similarly to logs. Use this endpoint to build complex…

CI Visibility Tests

  • POSTAggregate tests events/api/v2/ci/tests/analytics/aggregateThe API endpoint to aggregate CI Visibility test events into buckets of computed metrics and timeseries.
  • GETGet a list of tests events/api/v2/ci/tests/events?filter[query]=@test.name:test_foo @test.suite:github.com/DataDog/dd-go/model&filter[from]=2019-01-02T09:42:36.320Z&filter[to]=2019-01-03T09:42:36.320Z&sort=timestamp&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==&page[limit]=25List endpoint returns CI Visibility test events that match a search query. Results are paginated similarly to logs. Use this endpoint to see your latest test…
  • POSTSearch tests events/api/v2/ci/tests/events/searchList endpoint returns CI Visibility test events that match a search query. Results are paginated similarly to logs. Use this endpoint to build complex events…

CSM Agents

  • GETGet all CSM Agents/api/v2/csm/onboarding/agents?page=2&size=12&query=hostname:COMP-T2H4J27423&order_direction=ascGet the list of all CSM Agents running on your hosts and containers.
  • GETGet all CSM Serverless Agents/api/v2/csm/onboarding/serverless/agents?page=2&size=12&query=hostname:COMP-T2H4J27423&order_direction=ascGet the list of all CSM Serverless Agents running on your hosts and containers.

CSM Coverage Analysis

  • GETGet the CSM Cloud Accounts Coverage Analysis/api/v2/csm/onboarding/coverage_analysis/cloud_accountsGet the CSM Coverage Analysis of your Cloud Accounts. This is calculated based on the number of your Cloud Accounts that are scanned for security issues.
  • GETGet the CSM Hosts and Containers Coverage Analysis/api/v2/csm/onboarding/coverage_analysis/hosts_and_containersGet the CSM Coverage Analysis of your Hosts and Containers. This is calculated based on the number of agents running on your Hosts and Containers with CSM…
  • GETGet the CSM Serverless Coverage Analysis/api/v2/csm/onboarding/coverage_analysis/serverlessGet the CSM Coverage Analysis of your Serverless Resources. This is calculated based on the number of agents running on your Serverless Resources with CSM…

CSM Ownership

  • GETGet ownership settings for the org/api/v2/csm/ownership/settingsGet ownership settings for the org. When settings are unset, the API returns the default opt-out configuration with auto_tag set to true and confidence_level…
  • POSTUpdate ownership settings for the org/api/v2/csm/ownership/settingsUpdate ownership settings for the org.
  • GETCount untagged findings by ownership confidence/api/v2/csm/ownership/settings/untaggedCount findings with no team tag, grouped by ownership confidence level.
  • GETList ownership inferences for a resource/api/v2/security/ownership/:resource_idGet all current ownership inferences for a resource, one per owner type (user, team, service, unknown).
  • GETList ownership inference history for a resource/api/v2/security/ownership/:resource_id/history?cursor=eyJpZCI6OTh9&limit=25List inference history entries for a resource across all owner types, ordered from most recent to oldest. Uses cursor-based pagination.
  • GETGet an ownership inference by owner type/api/v2/security/ownership/:resource_id/:owner_typeGet the current ownership inference for a resource for a specific owner type. This endpoint supports ETag-based caching. Pass the previously returned ETag…
  • GETGet the evidence for an ownership inference/api/v2/security/ownership/:resource_id/:owner_type/evidenceGet the evidence versions backing the current ownership inference for a resource and owner type. This endpoint supports weak ETag caching. Pass the previously…
  • POSTSubmit feedback on an ownership inference/api/v2/security/ownership/:resource_id/:owner_type/feedbackSubmit feedback on the current ownership inference for a resource and owner type. Valid actions are confirm, reject, correct, and persist. The request must…
  • GETList ownership history by owner type/api/v2/security/ownership/:resource_id/:owner_type/history?cursor=eyJpZCI6OTh9&limit=25List inference history entries for a resource filtered by owner type, ordered from most recent to oldest. Uses cursor-based pagination.

CSM Settings

  • GETList agentless hosts/api/v2/csm/settings/agentless_hosts?page=0&size=10&query=cloud_provider:awsGet the list of agentless hosts for CSM, with optional pagination and filtering.
  • GETGet agentless host facet info/api/v2/csm/settings/agentless_hosts/facet_info?facet=cloud_provider&search=aws&query=cloud_provider:awsGet the value distribution for a specific agentless host facet, with optional search and filtering.
  • GETList agentless host facets/api/v2/csm/settings/agentless_hosts/facetsGet the list of available facets for filtering agentless hosts.
  • GETList unified hosts/api/v2/csm/settings/hosts?page=0&size=10&query=source:agentGet the list of unified hosts for CSM, combining agent and agentless host data, with optional pagination and filtering.
  • GETGet unified host facet info/api/v2/csm/settings/hosts/facet_info?facet=cloud_provider&search=aws&query=cloud_provider:awsGet the value distribution for a specific unified host facet, with optional search and filtering.
  • GETList unified host facets/api/v2/csm/settings/hosts/facetsGet the list of available facets for filtering unified hosts.

CSM Threats

  • GETGet all Workload Protection agent rules/api/v2/remote_config/products/cws/agent_rules?policy_id=6517fcc1-cec7-4394-a655-8d6e9d085255Get the list of Workload Protection agent rules. Note: This endpoint is not available for the Government (US1-FED) site. Please reference the (US1-FED)…
  • POSTCreate a Workload Protection agent rule/api/v2/remote_config/products/cws/agent_rulesCreate a new Workload Protection agent rule with the given parameters. Note: This endpoint is not available for the Government (US1-FED) site. Please…
  • GETGet a Workload Protection agent rule/api/v2/remote_config/products/cws/agent_rules/:agent_rule_id?policy_id=6517fcc1-cec7-4394-a655-8d6e9d085255Get the details of a specific Workload Protection agent rule. Note: This endpoint is not available for the Government (US1-FED) site. Please reference the…
  • DELETEDelete a Workload Protection agent rule/api/v2/remote_config/products/cws/agent_rules/:agent_rule_id?policy_id=6517fcc1-cec7-4394-a655-8d6e9d085255Delete a specific Workload Protection agent rule. Note: This endpoint is not available for the Government (US1-FED) site. Please reference the (US1-FED)…
  • PATCHUpdate a Workload Protection agent rule/api/v2/remote_config/products/cws/agent_rules/:agent_rule_id?policy_id=6517fcc1-cec7-4394-a655-8d6e9d085255Update a specific Workload Protection Agent rule. Returns the agent rule object when the request is successful. Note: This endpoint is not available for the…
  • GETGet all Workload Protection policies/api/v2/remote_config/products/cws/policyGet the list of Workload Protection policies. Note: This endpoint is not available for the Government (US1-FED) site. Please reference the (US1-FED) specific…
  • POSTCreate a Workload Protection policy/api/v2/remote_config/products/cws/policyCreate a new Workload Protection policy with the given parameters. Note: This endpoint is not available for the Government (US1-FED) site. Please reference…
  • GETDownload the Workload Protection policy/api/v2/remote_config/products/cws/policy/downloadThe download endpoint generates a Workload Protection policy file from your currently active Workload Protection agent rules, and downloads them as a .policy…
  • GETGet a Workload Protection policy/api/v2/remote_config/products/cws/policy/:policy_idGet the details of a specific Workload Protection policy. Note: This endpoint is not available for the Government (US1-FED) site. Please reference the…
  • DELETEDelete a Workload Protection policy/api/v2/remote_config/products/cws/policy/:policy_idDelete a specific Workload Protection policy. Note: This endpoint is not available for the Government (US1-FED) site. Please reference the (US1-FED) specific…
  • PATCHUpdate a Workload Protection policy/api/v2/remote_config/products/cws/policy/:policy_idUpdate a specific Workload Protection policy. Returns the policy object when the request is successful. Note: This endpoint is not available for the…

Showing 300 of 400 endpoints. Fork the collection to see all of them.

API details

Base URL
https://{subdomain}.{site}
https://{subdomain}.{site}
Authentication
OAuth 2.0 (authorization code flow) with 118 scopes
An API key in the DD-API-KEY header
An API key in the DD-APPLICATION-KEY header
A bearer token in the Authorization header
Operations
1798 operations on 1135 pathsGET 756POST 487DELETE 262PATCH 196PUT 97
24 marked deprecated
Main resources
Security Monitoring 189Incidents 92Cloud Cost Management 78Agent Observability 74Case Management 66AI Gateway 55Experiments 55Status Pages 39Synthetics 35Teams 35
Response formats
application/json application/json;datetime-format=rfc3339 application/zip text/csv
Description format
OpenAPI 3.0.0, API version 1.0

How to test the Datadog API V2 Collection in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Datadog API V2 Collection collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 118 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List AI Gateway budgets” (GET /api/v2/budgets), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Datadog API V2 Collection?

Collection of all Datadog Public endpoints. It is listed under Developer tools and has 1798 endpoints.

Who publishes the Datadog API V2 Collection?

It is listed from Datadog's public API description (an OpenAPI document), not published by Datadog on Swastik Codes. Anyone who controls datadoghq.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Datadog API V2 Collection?

Its description lists 2 base URLs: https://{subdomain}.{site}, https://{subdomain}.{site}. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the Datadog API V2 Collection?

It accepts 4 methods: OAuth 2.0 (authorization code flow) with 118 scopes; an API key in the DD-API-KEY header; an API key in the DD-APPLICATION-KEY header; A bearer token in the Authorization header.

How many endpoints does the Datadog API V2 Collection have?

1798 operations on 1135 paths (756 GET, 487 POST, 262 DELETE, 196 PATCH, 97 PUT). The largest groups are Security Monitoring, Incidents, Cloud Cost Management, Agent Observability. This listing's collection holds the first 400.

Is forking the Datadog API V2 Collection free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.