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

The Workflows API from Datadog — 7 operation(s) for workflows.

Datadog Workflows 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 Workflows. 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 13 operations across 7 paths, and defines 97 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}.

13 operations 7 paths 97 schemas 2 DELETE5 GET2 PATCH3 POST1 PUT

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 Workflows 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 13

Across 7 paths, the API surfaces 13 operations — 2 DELETE, 5 GET, 2 PATCH, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Workflows 13
GET
/api/v2/integration/ms-teams/configuration/workflows-webhook-handles
Datadog Get All Workflows Webhook Handles
ListWorkflowsWebhookHandles 1 param → 200400403404412429
POST
/api/v2/integration/ms-teams/configuration/workflows-webhook-handles
Datadog Create Workflows Webhook Handle
CreateWorkflowsWebhookHandle body → 201400403404409412429
DELETE
/api/v2/integration/ms-teams/configuration/workflows-webhook-handles/{handle_id}
Datadog Delete Workflows Webhook Handle
DeleteWorkflowsWebhookHandle 1 param → 204400403412429
GET
/api/v2/integration/ms-teams/configuration/workflows-webhook-handles/{handle_id}
Datadog Get Workflows Webhook Handle Information
GetWorkflowsWebhookHandle 1 param → 200400403404412429
PATCH
/api/v2/integration/ms-teams/configuration/workflows-webhook-handles/{handle_id}
Datadog Update Workflows Webhook Handle
UpdateWorkflowsWebhookHandle 1 param body → 200400403404409412429
POST
/api/v2/workflows
Datadog Create a Workflow
CreateWorkflow body → 201400403429
DELETE
/api/v2/workflows/{workflow_id}
Datadog Delete an Existing Workflow
DeleteWorkflow 1 param → 204403404429
GET
/api/v2/workflows/{workflow_id}
Datadog Get an Existing Workflow
GetWorkflow 1 param → 200400403404429
PATCH
/api/v2/workflows/{workflow_id}
Datadog Update an Existing Workflow
UpdateWorkflow 1 param body → 200400403404429
GET
/api/v2/workflows/{workflow_id}/instances
Datadog List Workflow Instances
ListWorkflowInstances 3 params → 200400403429
POST
/api/v2/workflows/{workflow_id}/instances
Datadog Execute a Workflow
CreateWorkflowInstance 1 param body → 200400403429
GET
/api/v2/workflows/{workflow_id}/instances/{instance_id}
Datadog Get a Workflow Instance
GetWorkflowInstance 2 params → 200400403404429
PUT
/api/v2/workflows/{workflow_id}/instances/{instance_id}/cancel
Datadog Cancel a Workflow Instance
CancelWorkflowInstance 2 params → 200400403404429

Schemas 97

The contract defines 97 schemas that model the data the API accepts and returns. The most detailed are Step (9 properties), WorkflowDataUpdateAttributes (8 properties), WorkflowDataAttributes (8 properties), Spec (7 properties). Each schema is shown below with its type and property counts.

Annotation
object
A list of annotations used in the workflow. These are like sticky notes for your workflow!
3 properties 3 required
SoftwareCatalogTriggerWrapper
object
Schema for a Software Catalog-based trigger.
2 properties 1 required
MicrosoftTeamsUpdateWorkflowsWebhookHandleRequest
object
Update Workflows webhook handle request.
1 property 1 required
WorkflowDataUpdate
object
Data related to the workflow being updated.
4 properties 2 required
APITrigger
object
Trigger a workflow from an API request. The workflow must be published.
1 property
StartStepNames
array
A list of steps that run first after a trigger fires.
UpdateWorkflowRequest
object
A request object for updating an existing workflow.
1 property 1 required
JSONAPIErrorItem
object
API error response body
5 properties
OutputSchemaParametersType
string
The definition of OutputSchemaParametersType object.
GithubWebhookTrigger
object
Trigger a workflow from a GitHub webhook. To trigger a workflow from GitHub, you must set a webhookSecret. In your GitHub Webhook Settings, set the Payload URL…
1 property
WorklflowGetInstanceResponse
object
The state of the given workflow instance.
1 property
CreateWorkflowResponse
object
The response object after creating a new workflow.
1 property 1 required
MicrosoftTeamsWorkflowsWebhookHandlesResponse
object
Response with a list of Workflows webhook handles.
1 property 1 required
StepDisplayBounds
object
The definition of StepDisplayBounds object.
2 properties
MicrosoftTeamsWorkflowsWebhookHandleAttributes
object
Workflows Webhook handle attributes.
2 properties
JSONAPIErrorResponse
object
API error response.
1 property 1 required
InputSchema
object
A list of input parameters for the workflow. These can be used as dynamic runtime values in your workflow.
1 property
CaseTrigger
object
Trigger a workflow from a Case. For automatic triggering a handle must be configured and the workflow must be published.
1 property
AppTriggerWrapper
object
Schema for an App-based trigger.
2 properties 1 required
WorklflowCancelInstanceResponse
object
Information about the canceled instance.
1 property
WorkflowTriggerWrapper
object
Schema for a Workflow-based trigger.
2 properties 1 required
GithubWebhookTriggerWrapper
object
Schema for a GitHub webhook-based trigger.
2 properties 1 required
Trigger
One of the triggers that can start the execution of a workflow.
UpdateWorkflowResponse
object
The response object after updating a workflow.
1 property
StepDisplay
object
The definition of StepDisplay object.
1 property
MicrosoftTeamsWorkflowsWebhookHandleRequestAttributes
object
Workflows Webhook handle attributes.
2 properties 2 required
WorkflowDataUpdateAttributes
object
The definition of WorkflowDataUpdateAttributes object.
8 properties
TriggerRateLimit
object
Defines a rate limit for a trigger.
2 properties
ConnectionEnvEnv
string
The definition of ConnectionEnvEnv object.
MicrosoftTeamsWorkflowsWebhookHandleResponseData
object
Workflows Webhook handle data from a response.
3 properties
WorkflowInstanceListItem
object
An item in the workflow instances list.
1 property
DatabaseMonitoringTriggerWrapper
object
Schema for a Database Monitoring-based trigger.
2 properties 1 required
WorkflowListInstancesResponse
object
Response returned when listing workflow instances.
2 properties
AnnotationDisplay
object
The definition of AnnotationDisplay object.
1 property
ScheduleTriggerWrapper
object
Schema for a Schedule-based trigger.
2 properties 1 required
WorkflowInstanceCreateMeta
object
Additional information for creating a workflow instance.
1 property
JSONAPIErrorItemSource
object
References to the source of the error.
3 properties
WorkflowListInstancesResponseMetaPage
object
Page information for the list instances response.
1 property
SecurityTriggerWrapper
object
Schema for a Security-based trigger.
2 properties 1 required
WorkflowDataAttributes
object
The definition of WorkflowDataAttributes object.
8 properties 2 required
IncidentTrigger
object
Trigger a workflow from an Incident. For automatic triggering a handle must be configured and the workflow must be published.
1 property
ConnectionGroup
object
The definition of ConnectionGroup object.
3 properties 3 required
ReadinessGateThresholdType
string
The definition of ReadinessGateThresholdType object.
AnnotationMarkdownTextAnnotation
object
The definition of AnnotationMarkdownTextAnnotation object.
1 property
WorklflowGetInstanceResponseData
object
The data of the instance response.
1 property
SelfServiceTriggerWrapper
object
Schema for a Self Service-based trigger.
2 properties 1 required
OutputSchemaParameters
object
The definition of OutputSchemaParameters object.
6 properties 2 required
SecurityTrigger
object
Trigger a workflow from a Security Signal or Finding. For automatic triggering a handle must be configured and the workflow must be published.
1 property
CaseTriggerWrapper
object
Schema for a Case-based trigger.
2 properties 1 required
WorklflowGetInstanceResponseDataAttributes
object
The attributes of the instance response data.
1 property
MonitorTrigger
object
Trigger a workflow from a Monitor. For automatic triggering a handle must be configured and the workflow must be published.
1 property
WorkflowDataRelationships
object
The definition of WorkflowDataRelationships object.
2 properties
MicrosoftTeamsCreateWorkflowsWebhookHandleRequest
object
Create Workflows webhook handle request.
1 property 1 required
APIErrorResponse
object
API error response.
1 property 1 required
WorkflowListInstancesResponseMeta
object
Metadata about the instances list
1 property
RetryStrategyLinear
object
The definition of RetryStrategyLinear object.
2 properties 2 required
WorkflowUserRelationshipType
string
The definition of WorkflowUserRelationshipType object.
CompletionCondition
object
The definition of CompletionCondition object.
3 properties 2 required
CompletionConditionOperator
string
The definition of CompletionConditionOperator object.
OutputSchema
object
A list of output parameters for the workflow.
1 property
InputSchemaParameters
object
The definition of InputSchemaParameters object.
5 properties 2 required
ConnectionEnv
object
A list of connections or connection groups used in the workflow.
3 properties 1 required
WorkflowInstanceCreateRequest
object
Request used to create a workflow instance.
1 property
WorkflowInstanceCreateResponseData
object
Data about the created workflow instance.
1 property
MicrosoftTeamsWorkflowsWebhookHandleType
string
Specifies the Workflows webhook handle resource type.
InputSchemaParametersType
string
The definition of InputSchemaParametersType object.
Parameter
object
The definition of Parameter object.
2 properties 2 required
WorkflowDataType
string
The definition of WorkflowDataType object.
DashboardTriggerWrapper
object
Schema for a Dashboard-based trigger.
2 properties 1 required
WorkflowInstanceCreateResponse
object
Response returned upon successful workflow instance creation.
1 property
Connection
object
The definition of Connection object.
2 properties 2 required
ReadinessGate
object
Used to merge multiple branches into a single branch.
1 property 1 required
ChangeEventTriggerWrapper
object
Schema for a Change Event-based trigger.
2 properties 1 required
OutboundEdge
object
The definition of OutboundEdge object.
2 properties 2 required
APITriggerWrapper
object
Schema for an API-based trigger.
2 properties 1 required
AnnotationDisplayBounds
object
The definition of AnnotationDisplayBounds object.
4 properties
NotebookTriggerWrapper
object
Schema for a Notebook-based trigger.
2 properties 1 required
WorkflowData
object
Data related to the workflow.
4 properties 2 required
MicrosoftTeamsWorkflowsWebhookHandleResponse
object
Response of a Workflows webhook handle.
1 property 1 required
CreateWorkflowRequest
object
A request object for creating a new workflow.
1 property 1 required
WorkflowUserRelationship
object
The definition of WorkflowUserRelationship object.
1 property
WorkflowUserRelationshipData
object
The definition of WorkflowUserRelationshipData object.
2 properties 2 required
MicrosoftTeamsWorkflowsWebhookHandleRequestData
object
Workflows Webhook handle data from a response.
2 properties 2 required
IncidentTriggerWrapper
object
Schema for an Incident-based trigger.
2 properties 1 required
SlackTriggerWrapper
object
Schema for a Slack-based trigger.
2 properties 1 required
RetryStrategy
object
The definition of RetryStrategy object.
2 properties 1 required
MicrosoftTeamsWorkflowsWebhookResponseAttributes
object
Workflows Webhook handle attributes.
1 property
RetryStrategyKind
string
The definition of RetryStrategyKind object.
ErrorHandler
object
Used to handle errors in an action.
2 properties 2 required
MonitorTriggerWrapper
object
Schema for a Monitor-based trigger.
2 properties 1 required
MicrosoftTeamsUpdateWorkflowsWebhookHandleRequestData
object
Workflows Webhook handle data from a response.
2 properties 2 required
CompletionGate
object
Used to create conditions before running subsequent actions.
2 properties 2 required
WorklflowCancelInstanceResponseData
object
Data about the canceled instance.
1 property
Spec
object
The spec defines what the workflow does.
7 properties
Step
object
A Step is a sub-component of a workflow. Each Step performs an action.
9 properties 2 required
ScheduleTrigger
object
Trigger a workflow from a Schedule. The workflow must be published.
1 property 1 required
GetWorkflowResponse
object
The response object after getting a workflow.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

datadog-workflows-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 Workflows 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.