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

The Send API from Datadog — 5 operation(s) for send.

Datadog Send 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 Send. 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 5 operations across 5 paths, and defines 65 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}.

5 operations 5 paths 65 schemas 5 POST

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 Send 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 5

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

Send 5
POST
/api/v2/ci/pipeline
Datadog Send Pipeline Event
CreateCIAppPipelineEvent body → 202400401403408413429500
POST
/api/v2/dora/deployment
Datadog Send a Deployment Event for Dora Metrics
CreateDORADeployment body → 200202400403429
POST
/api/v2/dora/incident
Datadog Send an Incident Event for Dora Metrics
CreateDORAIncident body → 200202400403429
POST
/api/v2/logs
Datadog Send Logs
SubmitLog 2 params body → 202400401403408413429500
POST
/api/v2/user_invitations
Datadog Send Invitation Emails
SendInvitations body → 201400403429

Schemas 65

The contract defines 65 schemas that model the data the API accepts and returns. The most detailed are CIAppPipelineEventFinishedPipeline (20 properties), CIAppPipelineEventInProgressPipeline (19 properties), CIAppPipelineEventJob (19 properties), CIAppPipelineEventStep (19 properties). Each schema is shown below with its type and property counts.

RelationshipToUserData
object
Relationship to user object.
2 properties 2 required
GitCommitSHA
string
Git Commit SHA.
CIAppPipelineEventPipelineInProgressStatus
string
The in progress status of the pipeline.
UsersType
string
Users resource type.
CIAppCreatePipelineEventRequestDataType
string
Type of the event.
DORADeploymentResponse
object
Response after receiving a DORA deployment event.
1 property 1 required
UserInvitationData
object
Object to create a user invitation.
2 properties 2 required
JSONAPIErrorItem
object
API error response body
5 properties
CIAppPipelineEventParameters
object
A map of key-value parameters or environment variables that were defined for the pipeline.
HTTPLog
array
Structured log message.
CIAppPipelineEventPipelineStatus
string
The final status of the pipeline.
CIAppCreatePipelineEventRequestAttributesResource
Details of the CI pipeline event.
CIAppPipelineEventStageStatus
string
The final status of the stage.
CIAppCIError
object
Contains information of the CI error.
4 properties
CIAppPipelineEventTags
array
A list of user-defined tags. The tags must follow the key:value pattern.
APIErrorResponse
object
API error response.
1 property 1 required
DORADeploymentType
string
JSON:API type for DORA deployment events.
DORADeploymentRequestAttributes
object
Attributes to create a DORA deployment event.
8 properties 3 required
CIAppPipelineEventMetrics
array
A list of user-defined metrics. The metrics must follow the key:value pattern and the value must be numeric.
DORAGitInfo
object
Git info for DORA Metrics events.
2 properties 2 required
CIAppPipelineEventParentPipeline
object
If the pipeline is triggered as child of another pipeline, this should contain the details of the parent pipeline.
2 properties 1 required
CIAppPipelineEventStepLevel
string
Used to distinguish between pipelines, stages, jobs and steps.
CIAppPipelineEventJobLevel
string
Used to distinguish between pipelines, stages, jobs, and steps.
UserInvitationsType
string
User invitations type.
UserInvitationsResponse
object
User invitations as returned by the API.
1 property
DORAIncidentRequestData
object
The JSON:API data.
1 property 1 required
HTTPCIAppError
object
List of errors.
3 properties
JSONAPIErrorItemSource
object
References to the source of the error.
3 properties
CIAppPipelineEventStep
object
Details of a CI step.
19 properties 8 required
CIAppPipelineEventFinishedPipeline
object
Details of a finished pipeline.
20 properties 8 required
JSONAPIErrorResponse
object
API error response.
1 property 1 required
CIAppGitInfo
object
If pipelines are triggered due to actions to a Git repository, then all payloads must contain this. Note that either tag or branch has to be provided, but not…
12 properties 3 required
CIAppPipelineEventStage
object
Details of a CI stage.
16 properties 8 required
DORADeploymentRequest
object
Request to create a DORA deployment event.
1 property 1 required
DORAIncidentRequest
object
Request to create a DORA incident event.
1 property 1 required
DORADeploymentRequestData
object
The JSON:API data.
1 property 1 required
DORAIncidentResponse
object
Response after receiving a DORA incident event.
1 property 1 required
CIAppPipelineEventPreviousPipeline
object
If the pipeline is a retry, this should contain the details of the previous attempt.
2 properties 1 required
HTTPLogError
object
List of errors.
3 properties
UserInvitationRelationships
object
Relationships data for user invitation.
1 property 1 required
CIAppPipelineEventJob
object
Details of a CI job.
19 properties 9 required
CIAppPipelineEventInProgressPipeline
object
Details of a running pipeline.
19 properties 7 required
DORAIncidentRequestAttributes
object
Attributes to create a DORA incident event.
10 properties 1 required
CIAppCIErrorDomain
string
Error category used to differentiate between issues related to the developer or provider environments.
DORADeploymentResponseData
object
The JSON:API data.
2 properties 1 required
CIAppHostInfo
object
Contains information of the host running the pipeline, stage, job, or step.
4 properties
UserInvitationsRequest
object
Object to invite users to join the organization.
1 property 1 required
HTTPLogErrors
object
Invalid query performed.
1 property
CIAppPipelineEventPipeline
Details of the top level pipeline, build, or workflow of your CI.
DORAIncidentResponseData
object
Response after receiving a DORA incident event.
2 properties 1 required
GitRepositoryURL
string
Git Repository URL
CIAppCreatePipelineEventRequest
object
Request object.
1 property
UserInvitationDataAttributes
object
Attributes of a user invitation.
4 properties
CIAppPipelineEventStepStatus
string
The final status of the step.
CIAppPipelineEventJobStatus
string
The final status of the job.
CIAppCreatePipelineEventRequestAttributes
object
Attributes of the pipeline event to create.
4 properties 1 required
CIAppPipelineEventPipelineLevel
string
Used to distinguish between pipelines, stages, jobs, and steps.
DORAIncidentType
string
JSON:API type for DORA incident events.
RelationshipToUser
object
Relationship to user.
1 property 1 required
HTTPCIAppErrors
object
Errors occurred.
1 property
CIAppCreatePipelineEventRequestData
object
Data of the pipeline event to create.
2 properties
CIAppPipelineEventStageLevel
string
Used to distinguish between pipelines, stages, jobs and steps.
UserInvitationResponseData
object
Object of a user invitation returned by the API.
4 properties
ContentEncoding
string
HTTP header used to compress the media-type.
HTTPLogItem
object
Logs that are sent over HTTP.
5 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

datadog-send-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 Send 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.