How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Datadog Patch API

The Patch API from Datadog — 5 operation(s) for patch.

Datadog Patch API is one of 186 APIs that Datadog publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, and 4 JSON Schemas.

This API exposes 3 operations across 3 paths, and defines 33 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 3 base URLs: https://{subdomain}.{site}, {protocol}://{name}, https://{subdomain}.{site}.

3 operations 3 paths 33 schemas 3 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.datadoghq.com
Authentication
OAuth 2.0, API Key, API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 4

Datadog Patch API declares 4 security schemes for authenticating requests. It supports OAuth 2.0 (AuthZ) using the authorizationCode flow, exposing 68 scopes. An API key is passed in the header as DD-API-KEY (apiKeyAuth). An API key is passed in the header as DD-APPLICATION-KEY (appKeyAuth). It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • AuthZ — This API uses OAuth 2 with the implicit grant flow.
  • apiKeyAuth — Your Datadog API Key.
  • appKeyAuth — Your Datadog APP Key.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 PATCH. Each is listed below with its method, path, parameters, and response codes.

Patch 3
PATCH
/api/v2/scim/Users/{user_uuid}
Datadog Patch User
PatchSCIMUser 1 param body → 200400403404429
PATCH
/api/v2/security/signals/notification_rules/{id}
Datadog Patch a Signal-based Notification Rule
PatchSignalNotificationRule 1 param body → 200400403404422429
PATCH
/api/v2/security/vulnerabilities/notification_rules/{id}
Datadog Patch a Vulnerability-based Notification Rule
PatchVulnerabilityNotificationRule 1 param body → 200400403404422429

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are NotificationRuleAttributes (10 properties), ExternalUser (8 properties), PatchNotificationRuleParametersDataAttributes (6 properties), JSONAPIErrorItem (5 properties). Each schema is shown below with its type and property counts.

APIErrorResponse
object
API error response.
1 property 1 required
EmailTypeType
string
The type of email.
ExternalUser
object
Definition of a user.
8 properties
PatchNotificationRuleParametersDataAttributes
object
Attributes of the notification rule patch request. It is required to update the version of the rule when patching it.
6 properties
ExternalUserPatchRequestOperationsItemsOp
string
The operation to be performed.
RuleSeverity
string
Severity of a security rule.
ExternalUserNameType
object
The components of user's real name
1 property
TimeAggregation
integer
Time aggregation period (in seconds) is used to aggregate the results of the notification rule evaluation. Results are aggregated over a selected time frame us…
PatchNotificationRuleParametersData
object
Data of the notification rule patch request: the rule ID, the rule type, and the rule attributes. All fields are required.
3 properties 3 required
NotificationRuleQuery
string
The query is composed of one or several key:value pairs, which can be used to filter security issues on tags and attributes.
Version
integer
Version of the notification rule. It is updated when the rule is modified.
RuleTypesItems
string
Security rule type which can be used in security rules. Signal-based notification rules can filter signals based on rule types applicationsecurity, logdetectio…
RuleUser
object
User creating or modifying a rule.
2 properties
NotificationRulesType
string
The rule type associated to notification rules.
ExternalUserPatchRequest
object
Request object for patching a user.
2 properties
ID
string
The ID of a notification rule.
PatchNotificationRuleParameters
object
Body of the notification rule patch request.
1 property
NotificationRuleAttributes
object
Attributes of the notification rule.
10 properties 9 required
Enabled
boolean
Field used to enable or disable the rule.
NotificationRuleResponse
object
Response object which includes a notification rule.
1 property
RuleTypes
array
Security rule types used as filters in security rules.
ExternalUserEmailType
object
Email address for the user.
3 properties
Selectors
object
Selectors are used to filter security issues for which notifications should be generated. Users can specify rule severities, rule types, a query to filter secu…
4 properties 1 required
ExternalUserPatchRequestOperationsItems
object
The definition of an individual patch operation in a patch request.
3 properties
RuleName
string
Name of the notification rule.
Targets
array
List of recipients to notify when a notification rule is triggered. Many different target types are supported, such as email addresses, Slack channels, and Pag…
JSONAPIErrorItemSource
object
References to the source of the error.
3 properties
NotificationRule
object
Notification rules allow full control over notifications generated by the various Datadog security products. They allow users to define the conditions under wh…
3 properties 3 required
TriggerSource
string
The type of security issues on which the rule applies. Notification rules based on security signals need to use the trigger source "securitysignals", while not…
JSONAPIErrorResponse
object
API error response.
1 property 1 required
Date
integer
Date as Unix timestamp in milliseconds.
ExternalUserMeta
object
Metadata associated with a user.
4 properties
JSONAPIErrorItem
object
API error response body
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

datadog-patch-api-openapi.yml Raw ↑

Other APIs Datadog publishes across the network.

Datadog Dashboards API
Datadog Synthetics API
Datadog Service Level Objectives API
Datadog Security Monitoring API
Datadog Service Definition API
Datadog Software Catalog API
Datadog Users API
Datadog Roles API
Datadog Key Management API
Datadog Organizations API
Datadog Downtimes API
Datadog RUM API
Where this information came from

This is an independent, third-party profile of Datadog Patch API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.