Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Novu Workflows API

All notifications are sent via a workflow. Each workflow acts as a container for the logic and blueprint that are associated with a type of notification in your system.

Novu Workflows API is one of 19 APIs that Novu publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 26 JSON Schema definitions.

Tagged areas include Workflows. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, a getting-started guide, and 26 JSON Schemas.

This API exposes 9 operations across 5 paths, and defines 96 schemas. It is described by OpenAPI 3.1.0, at version 3.15.0.

Requests are made against 2 base URLs: https://api.novu.co, https://eu.api.novu.co.

9 operations 5 paths 96 schemas 1 DELETE3 GET1 PATCH2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3.15.0
Base URL
https://api.novu.co
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Novu Workflows API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (secretKey). By default, every request must be authenticated.

  • secretKey — API key authentication. Allowed headers-- "Authorization: ApiKey ".

Paths & Operations 9

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

Workflows 9

All notifications are sent via a workflow. Each workflow acts as a container for the logic and blueprint that are associated with a type of notification in your system.

POST
/v2/workflows
Novu Create a Workflow
WorkflowController_create body → 201400401403404405409413
GET
/v2/workflows
Novu List All Workflows
WorkflowController_searchWorkflows 7 params → 200400401403404405409413
PUT
/v2/workflows/{workflowId}/sync
Novu Sync a Workflow
WorkflowController_sync 1 param body → 200400401403404405409413
PUT
/v2/workflows/{workflowId}
Novu Update a Workflow
WorkflowController_update 1 param body → 200400401403404405409413
GET
/v2/workflows/{workflowId}
Novu Retrieve a Workflow
WorkflowController_getWorkflow 2 params → 200400401403404405409413
DELETE
/v2/workflows/{workflowId}
Novu Delete a Workflow
WorkflowController_removeWorkflow 1 param → 204400401403404405409413
PATCH
/v2/workflows/{workflowId}
Novu Update a Workflow
WorkflowController_patchWorkflow 1 param body → 200400401403404405409413
POST
/v2/workflows/{workflowId}/step/{stepId}/preview
Novu Generate a Step Preview
WorkflowController_generatePreview 2 params body → 201400401403404405409413
GET
/v2/workflows/{workflowId}/steps/{stepId}
Novu Retrieve Workflow Step
WorkflowController_getWorkflowStepData 2 params → 200400401403404405409413

Schemas 96

The contract defines 96 schemas that model the data the API accepts and returns. The most detailed are WorkflowResponseDto (23 properties), WorkflowListResponseDto (16 properties), SubscriberResponseDtoOptional (14 properties), SmsStepResponseDto (13 properties). Each schema is shown below with its type and property counts.

ContentIssueEnum
string
Type of step content issue
ChatStepUpsertDto
object
5 properties 2 required
WorkflowResponseDto
object
23 properties 11 required
UpdateWorkflowDto
object
12 properties 4 required
CustomControlDto
object
1 property
CustomStepUpsertDto
object
5 properties 2 required
InAppStepResponseDto
object
13 properties 10 required
HttpRequestKeyValuePairDto
object
2 properties 2 required
ThrottleControlsMetadataResponseDto
object
3 properties 1 required
ValidationErrorDto
object
7 properties 4 required
InAppRenderOutput
object
7 properties 1 required
HttpRequestStepResponseDto
object
13 properties 10 required
DelayControlsMetadataResponseDto
object
3 properties 1 required
InAppStepUpsertDto
object
5 properties 2 required
ChatRenderOutput
object
1 property 1 required
StepTypeEnum
string
Type of the step
WorkflowListResponseDto
object
16 properties 10 required
LookBackWindowDto
object
2 properties 2 required
ChannelCredentials
object
8 properties
UiSchemaGroupEnum
string
Group of the UI Schema
SmsStepUpsertDto
object
5 properties 2 required
UiSchema
object
2 properties
PushRenderOutput
object
2 properties 2 required
CreateWorkflowDto
object
12 properties 3 required
RuntimeIssueDto
object
WorkflowStatusEnum
string
Status of the workflow
ThrottleStepUpsertDto
object
5 properties 2 required
HttpRequestControlsMetadataResponseDto
object
3 properties 1 required
PatchWorkflowDto
object
7 properties
ChannelPreferenceDto
object
1 property 1 required
StepResponseDto
object
13 properties 10 required
WorkflowPreferencesDto
object
2 properties 2 required
ChatControlsMetadataResponseDto
object
3 properties 1 required
DigestControlsMetadataResponseDto
object
3 properties 1 required
PreviewErrorDto
object
3 properties 3 required
WorkflowResponseDtoSortField
string
ChatStepResponseDto
object
13 properties 10 required
WorkflowPreferencesResponseDto
object
2 properties 1 required
EmailRenderOutput
object
2 properties 2 required
ResourceOriginEnum
string
Origin of the layout
PushControlDto
object
3 properties
IntegrationIssueEnum
string
Type of integration issue
DelayControlDto
object
5 properties 1 required
DirectionEnum
string
ListWorkflowResponse
object
2 properties 2 required
DigestRegularOutput
object
4 properties 2 required
ControlsMetadataDto
object
2 properties
StepIssuesDto
object
2 properties
CustomControlsMetadataResponseDto
object
3 properties 1 required
ThrottleStepResponseDto
object
13 properties 10 required
InAppControlsMetadataResponseDto
object
3 properties 1 required
UiComponentEnum
string
Component type for the UI Schema Property
PreferencesRequestDto
object
2 properties
SmsStepResponseDto
object
13 properties 10 required
ChannelSettingsDto
object
4 properties 3 required
DelayStepResponseDto
object
13 properties 10 required
SyncWorkflowDto
object
1 property 1 required
PushControlsMetadataResponseDto
object
3 properties 1 required
SmsControlDto
object
2 properties
EmailControlsMetadataResponseDto
object
3 properties 1 required
GeneratePreviewResponseDto
object
4 properties 2 required
PreviewPayloadDto
object
5 properties
ConstraintValidation
object
2 properties 1 required
StepListResponseDto
object
3 properties 2 required
ErrorDto
object
6 properties 3 required
WorkflowCreationSourceEnum
string
Source of workflow creation
TimeUnitEnum
string
Time unit
ThrottleControlDto
object
7 properties 1 required
GeneratePreviewRequestDto
object
2 properties
StepIntegrationIssue
object
3 properties 2 required
SmsRenderOutput
object
1 property 1 required
PushStepResponseDto
object
13 properties 10 required
EmailStepUpsertDto
object
5 properties 2 required
WorkflowPreferenceDto
object
2 properties 2 required
SubscriberResponseDtoOptional
object
14 properties
HttpRequestStepUpsertDto
object
5 properties 2 required
RedirectDto
object
2 properties 1 required
ChatControlDto
object
2 properties
EmailControlDto
object
6 properties 2 required
DelayStepUpsertDto
object
5 properties 2 required
DigestStepUpsertDto
object
5 properties 2 required
SeverityLevelEnum
string
Severity of the workflow
HttpMethodEnum
string
HTTP method
UserResponseDto
object
4 properties 1 required
StepContentIssueDto
object
3 properties 2 required
DigestStepResponseDto
object
13 properties 10 required
HttpRequestControlDto
object
7 properties 2 required
DigestControlDto
object
7 properties
CustomStepResponseDto
object
13 properties 10 required
UiSchemaProperty
object
3 properties 1 required
InAppControlDto
object
9 properties
SmsControlsMetadataResponseDto
object
3 properties 1 required
EmailStepResponseDto
object
13 properties 10 required
PushStepUpsertDto
object
5 properties 2 required
ChatOrPushProviderEnum
string
The provider identifier for the credentials
ActionDto
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

novu-workflows-api-openapi.yml Raw ↑

Other APIs Novu publishes across the network.

Novu Inbox / In-App API
Novu Framework (Code-First Workflows)
Novu MCP Server
Novu Activity API
Novu Channel Connections API
Novu Channel Endpoints API
Novu Contexts API
Novu Domains API
Novu Environment Variables API
Novu Environments API
Novu Events API
Novu Integrations API