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 Edit API

The Edit API from Datadog — 6 operation(s) for edit.

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

This API exposes 4 JSON Schema definitions.

Tagged areas include Edit. 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 6 operations across 6 paths, and defines 80 schemas. It is described by OpenAPI 3.0.0, at version 1.0.

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

6 operations 6 paths 80 schemas 6 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.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 Edit 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 6

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

Edit 6
PATCH
/api/v2/api_keys/{api_key_id}
Datadog Edit an Api Key
UpdateAPIKey 1 param body → 200400403404429
PATCH
/api/v2/application_keys/{app_key_id}
Datadog Edit an Application Key
UpdateApplicationKey 1 param body → 200400403404429
PATCH
/api/v2/authn_mappings/{authn_mapping_id}
Datadog Edit an Authn Mapping
UpdateAuthNMapping 1 param body → 200400403404409422429
PATCH
/api/v2/current_user/application_keys/{app_key_id}
Datadog Edit an Application Key Owned by Current User
UpdateCurrentUserApplicationKey 1 param body → 200400403404429
PATCH
/api/v2/monitor/policy/{policy_id}
Datadog Edit a Monitor Configuration Policy
UpdateMonitorConfigPolicy 1 param body → 200403404422429
PATCH
/api/v2/service_accounts/{service_account_id}/application_keys/{app_key_id}
Datadog Edit an Application Key for This Service Account
UpdateServiceAccountApplicationKey 2 params body → 200400403404429

Schemas 80

The contract defines 80 schemas that model the data the API accepts and returns. The most detailed are UserAttributes (12 properties), AuthNMappingTeamAttributes (7 properties), FullAPIKeyAttributes (7 properties), AuthNMappingAttributes (5 properties). Each schema is shown below with its type and property counts.

UsersType
string
Users resource type.
AuthNMappingIncluded
Included data in the AuthN Mapping response.
APIKeyRelationships
object
Resources related to the API key.
2 properties
LeakedKeyAttributes
object
The definition of LeakedKeyAttributes object.
2 properties 1 required
RelationshipToSAMLAssertionAttributeData
object
Data of AuthN Mapping relationship to SAML Assertion Attribute.
2 properties 2 required
APIKeyResponse
object
Response for retrieving an API key.
2 properties
AuthNMappingResponse
object
AuthN Mapping response from the API.
2 properties
UserAttributes
object
Attributes of user object returned by the API.
12 properties
FullAPIKey
object
Datadog API key.
4 properties
MonitorConfigPolicyEditData
object
A monitor configuration policy data.
3 properties 3 required
PartialApplicationKeyResponse
object
Response for retrieving a partial application key.
2 properties
APIKeyResponseIncludedItem
An object related to an API key.
MonitorConfigPolicyTagPolicy
object
Tag attributes of a monitor configuration policy.
3 properties
MonitorConfigPolicyEditRequest
object
Request for editing a monitor configuration policy.
1 property 1 required
RoleAttributes
object
Attributes of the role.
4 properties
APIKeyUpdateAttributes
object
Attributes used to update an API Key.
3 properties 1 required
FullApplicationKey
object
Datadog application key.
4 properties
ApplicationKeyUpdateAttributes
object
Attributes used to update an application Key.
2 properties
User
object
User object returned by the API.
4 properties
AuthNMapping
object
The AuthN Mapping object returned by API.
4 properties 2 required
RelationshipToUser
object
Relationship to user.
1 property 1 required
RelationshipToTeamData
object
Relationship to Team object.
2 properties
APIKeysType
string
API Keys resource type.
RelationshipToOrganization
object
Relationship to an organization.
1 property 1 required
RelationshipToPermissionData
object
Relationship to permission object.
2 properties
ApplicationKeyResponseIncludedItem
An object related to an application key.
RelationshipToUserData
object
Relationship to user object.
2 properties 2 required
AuthNMappingUpdateData
object
Data for updating an AuthN Mapping.
4 properties 2 required
RelationshipToTeam
object
Relationship to team.
1 property
RelationshipToRole
object
Relationship to role.
1 property
AuthNMappingRelationshipToRole
object
Relationship of AuthN Mapping to a Role.
1 property 1 required
ApplicationKeyResponse
object
Response for retrieving an application key.
2 properties
SAMLAssertionAttribute
object
SAML assertion attribute.
3 properties 2 required
FullApplicationKeyAttributes
object
Attributes of a full application key.
5 properties
TeamType
string
Team type
MonitorConfigPolicyResponseData
object
A monitor configuration policy data.
3 properties
SAMLAssertionAttributeAttributes
object
Key/Value pair of attributes used in SAML assertion attributes.
2 properties
AuthNMappingUpdateRequest
object
Request to update an AuthN Mapping.
1 property 1 required
AuthNMappingUpdateAttributes
object
Key/Value pair of attributes used for update request.
2 properties
OrganizationsType
string
Organizations resource type.
MonitorConfigPolicyAttributeResponse
object
Policy and policy type for a monitor configuration policy.
2 properties
ApplicationKeyRelationships
object
Resources related to the application key.
1 property
LeakedKey
object
The definition of LeakedKey object.
3 properties 3 required
ApplicationKeysType
string
Application Keys resource type.
MonitorConfigPolicyResponse
object
Response for retrieving a monitor configuration policy.
1 property
AuthNMappingRelationships
object
All relationships associated with AuthN Mapping.
3 properties
MonitorConfigPolicyType
string
The monitor configuration policy type.
AuthNMappingTeam
object
Team.
3 properties
FullAPIKeyAttributes
object
Attributes of a full API key.
7 properties
APIErrorResponse
object
API error response.
1 property 1 required
UserResponseRelationships
object
Relationships of the user object returned by the API.
4 properties
ApplicationKeyUpdateRequest
object
Request used to update an application key.
1 property 1 required
AuthNMappingRelationshipToTeam
object
Relationship of AuthN Mapping to a Team.
1 property 1 required
RoleResponseRelationships
object
Relationships of the role object returned by the API.
1 property
RelationshipToRoleData
object
Relationship to role object.
2 properties
ApplicationKeyUpdateData
object
Object used to update an application key.
3 properties 3 required
RelationshipToOrganizationData
object
Relationship to organization object.
2 properties 2 required
PartialApplicationKeyAttributes
object
Attributes of a partial application key.
4 properties
MonitorConfigPolicyResourceType
string
Monitor configuration policy resource type.
Role
object
Role object returned by the API.
4 properties 1 required
RelationshipToUsers
object
Relationship to users.
1 property 1 required
AuthNMappingsType
string
AuthN Mappings resource type.
RelationshipToSAMLAssertionAttribute
object
AuthN Mapping relationship to SAML Assertion Attribute.
1 property 1 required
APIKeyUpdateData
object
Object used to update an API key.
3 properties 3 required
MonitorConfigPolicyPolicy
Configuration for the policy.
SAMLAssertionAttributesType
string
SAML assertion attributes resource type.
NullableRelationshipToUserData
object
Relationship to user object.
2 properties 2 required
PermissionsType
string
Permissions resource type.
PartialApplicationKey
object
Partial Datadog application key.
4 properties
RelationshipToRoles
object
Relationship to roles.
1 property
LeakedKeyType
string
The definition of LeakedKeyType object.
RelationshipToOrganizations
object
Relationship to organizations.
1 property 1 required
AuthNMappingTeamAttributes
object
Team attributes.
7 properties
NullableRelationshipToUser
object
Relationship to user.
1 property 1 required
APIKeyUpdateRequest
object
Request used to update an API key.
1 property 1 required
AuthNMappingUpdateRelationships
Relationship of AuthN Mapping update object to a Role or Team.
AuthNMappingAttributes
object
Attributes of AuthN Mapping.
5 properties
RolesType
string
Roles type.
RelationshipToPermissions
object
Relationship to multiple permissions objects.
1 property
MonitorConfigPolicyAttributeEditRequest
object
Policy and policy type for a monitor configuration policy.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

datadog-edit-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 Edit 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.