Knock Workflows API is one of 35 APIs that Knock publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 2 JSON Schema definitions.
Tagged areas include Workflows. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.
This API exposes
9 operations
across 8 paths,
and defines 88 schemas.
It is described by OpenAPI 3.2.0, at version 1.0.
Requests are made against a single base URL, https://api.knock.app.
The identity and technical contract details declared by the specification.
WorkflowWebhookStep
object
A webhook step within a workflow to send an HTTP request to a generic channel. Read more in the [docs](https://docs.knock.app/designing-workflows/channel-step).
10 properties
3 required
EmailMarkdownBlock
object
A markdown block in an email template.
6 properties
2 required
PreferenceSetChannelTypeSetting
object
A set of settings for a channel type. Currently, this can only be a list of conditions to apply.
1 property
1 required
EmailImageBlock
object
An image block in an email template.
8 properties
2 required
ShowWorkflowResponse
object
A workflow object.
18 properties
9 required
ConditionGroupAllMatch
object
A group of conditions that must all be met.
1 property
WorkflowSmsStep
object
A SMS step within a workflow. Read more in the [docs](https://docs.knock.app/designing-workflows/channel-step).
11 properties
3 required
RunWorkflowRequest
object
A request to run (test) a workflow.
5 properties
1 required
ChatTemplate
object
A chat template.
3 properties
1 required
SlackTokenConnection
object
A Slack connection token.
3 properties
WorkflowTriggerWorkflowStep
object
A workflow trigger function step. Read more in the [docs](https://docs.knock.app/designing-workflows/trigger-workflow-function).
6 properties
3 required
SendWindow
object
A send window time for a notification. Describes a single day.
4 properties
2 required
SlackChannelData
object
Slack channel data.
2 properties
1 required
InlineTenantRequest
An request to set a tenant inline.
RecipientRequest
Specifies a recipient in a request. This can either be a user identifier (string), an inline user request (object), or an inline object request, which is deter…
WebhookTemplate
object
A webhook template. By default, a webhook step will use the request settings you configured in your webhook channel. You can override this as you see fit on a…
5 properties
2 required
EmailVisualBlocks
array
The visual blocks that make up the email template.
AWSSNSPushChannelDataTargetARNsOnly
object
AWS SNS push channel data.
1 property
1 required
InlinePreferenceSetRequest
object
Inline set preferences for a recipient, where the key is the preference set id. Preferences that are set inline will be merged into any existing preferences ra…
EmailChannelSettings
object
Email channel settings. Only used as configuration as part of a workflow channel step.
9 properties
WorkflowUpdateObjectStep
object
An update object step. Updates properties of a specific object referenced in the workflow.
6 properties
3 required
InlineChannelDataRequest
object
A request to set channel data for a type of channel inline.
RecipientReference_2
A reference to a recipient, either a user identifier (string) or an object reference (ID, collection).
WorkflowBatchStep
object
A batch function step. Read more in the [docs](https://docs.knock.app/designing-workflows/batch-function).
5 properties
3 required
MsTeamsTokenConnection
object
Microsoft Teams token connection.
4 properties
WorkflowUpdateDataStep
object
An update data function step. Merges data into the workflow's data scope for use in subsequent steps.
6 properties
3 required
EmailPartialBlock
object
A partial block in an email template, used to render a reusable partial component.
7 properties
4 required
TenantRequest
object
A tenant to be set in the system. You can supply any additional properties on the tenant object.
5 properties
1 required
WorkflowDelayStep
object
A delay function step. Read more in the [docs](https://docs.knock.app/designing-workflows/delay-function).
6 properties
3 required
Condition_2
object
A condition to be evaluated.
3 properties
3 required
EmailButtonSetBlock
object
A button set block in an email template.
5 properties
2 required
PushChannelDataDevicesOnly
object
Push channel data.
1 property
1 required
DiscordIncomingWebhookConnection
object
Discord incoming webhook connection.
1 property
1 required
AWSSNSPushChannelDataDevicesOnly
object
AWS SNS push channel data.
1 property
1 required
ChatChannelSettings
object
Chat channel settings. Only used as configuration as part of a workflow channel step.
2 properties
WorkflowThrottleStep
object
A throttle function step. Read more in the [docs](https://docs.knock.app/designing-workflows/throttle-function).
6 properties
3 required
TriggerWorkflowResponse
object
The response from triggering a workflow.
1 property
1 required
WorkflowFetchStep
object
A fetch function step. Retrieves data from an external source and merges it into the workflow's data scope for use in later steps. Read more in the [docs](http…
6 properties
3 required
MsTeamsChannelData
object
Microsoft Teams channel data.
2 properties
1 required
WorkflowEmailStep
object
An email step within a workflow. Read more in the [docs](https://docs.knock.app/designing-workflows/channel-step).
11 properties
3 required
PreferenceSetRequest
object
A request to set a preference set for a recipient.
6 properties
PreferenceSetChannelSetting
object
A set of settings for a specific channel. Currently, this can only be a list of conditions to apply.
1 property
1 required
PushChannelDataTokensOnly
object
Push channel data.
1 property
1 required
ConditionGroup
object
A group of conditions to be evaluated.
RecipientReference
object
A recipient reference, used when referencing a recipient by either their ID (for a user), or by a reference for an object.
WorkflowChatStep
object
A chat step within a workflow. Read more in the [docs](https://docs.knock.app/designing-workflows/channel-step).
11 properties
3 required
Workflow
object
A workflow object. Read more in the [docs](https://docs.knock.app/concepts/workflows).
16 properties
9 required
ConditionGroupAnyMatch
object
A group of conditions that any must be met. Can contain nested alls.
1 property
RunWorkflowResponse
object
A response to a run workflow request.
1 property
1 required
EmailButtonSetBlockButton
object
A button in a button set block.
5 properties
3 required
EmailHtmlBlock
object
An HTML block in an email template.
5 properties
2 required
InlineIdentifyUserRequest
object
A set of parameters to inline-identify a user with. Inline identifying the user will ensure that the user is available before the request is executed in Knock.…
10 properties
1 required
PreferenceSetChannels
object
Channel preferences.
OneSignalChannelDataPlayerIdsOnly
object
OneSignal channel data.
1 property
1 required
PreviewWorkflowTemplateRequest
object
A request to preview a workflow template.
4 properties
1 required
InAppFeedTemplate
object
An in-app feed template.
3 properties
1 required
CancelWorkflowRequest
object
When invoked using a specific workflow key and cancellation key, will cancel any queued workflow runs associated with that key/cancellation key pair. Can optio…
2 properties
1 required
WorkflowRandomCohortStep
object
An experiment step. Deterministically assigns recipients to percentage-based cohorts for A/B testing and experimentation.
6 properties
3 required
SlackIncomingWebhookConnection
object
A Slack connection incoming webhook.
1 property
1 required
EmailTemplate
object
An email message template.
6 properties
2 required
SmsChannelSettings
object
SMS channel settings. Only used as configuration as part of a workflow channel step.
1 property
WorkflowStep
object
A step within a workflow. Each workflow step, regardless of its type, share a common set of core attributes (type, ref, name, description, conditions).
Duration
object
A duration of time, represented as a unit and a value.
2 properties
2 required
TriggerWorkflowRequest
object
A request to trigger a notification workflow.
5 properties
1 required
WorkflowRequest
object
A workflow request for upserting a workflow.
8 properties
2 required
WorkflowBranchStep
object
A branch function step. Read more in the [docs](https://docs.knock.app/designing-workflows/branch-function).
5 properties
3 required
WorkflowUpdateUserStep
object
An update user step. Updates properties of a specific user referenced in the workflow.
6 properties
3 required
InAppFeedChannelSettings
object
In-app feed channel settings. Only used as configuration as part of a workflow channel step.
1 property
PushTemplate
object
A push notification template.
3 properties
3 required
EmailDividerBlock
object
A divider block in an email template.
4 properties
1 required
WorkflowPushStep
object
A push step within a workflow. Read more in the [docs](https://docs.knock.app/designing-workflows/channel-step).
11 properties
3 required
PreferenceSetWorkflowCategorySetting
object
Workflow or category preferences within a preference set
Condition
object
A condition to be evaluated.
3 properties
2 required
DiscordChannelConnection
object
Discord channel connection.
1 property
1 required
MemberUser
object
Information about a user within the Knock dashboard. Not to be confused with an external user (recipient) of a workflow.
6 properties
4 required
MsTeamsIncomingWebhookConnection
object
Microsoft Teams incoming webhook connection.
1 property
1 required
RequestTemplate
object
A request template for a fetch function step.
5 properties
2 required
SmsTemplate
object
An SMS template.
2 properties
1 required
PreferenceSetChannelTypes
object
Channel type preferences.
6 properties
InlineIdentifyObjectRequest
object
A custom [Object](/concepts/objects) entity which belongs to a collection.
6 properties
2 required
PushChannelSettings
object
Push channel settings. Only used as configuration as part of a workflow channel step.
1 property
PreviewWorkflowTemplateResponse
object
A response to a preview workflow template request.
3 properties
3 required
DiscordChannelData
object
Discord channel data.
1 property
1 required
WorkflowInAppFeedStep
object
An in-app feed step within a workflow. Read more in the [docs](https://docs.knock.app/designing-workflows/channel-step).
11 properties
3 required
WorkflowUpdateTenantStep
object
An update tenant step. Updates properties of a specific tenant referenced in the workflow.
6 properties
3 required
WorkflowAIAgentStep
object
An AI agent function step. Fetches data from an AI model and merges it into the workflow's data scope for use in later steps. Supports Liquid templating in the…
6 properties
3 required
PageInfo
object
The information about a paginated result.
3 properties
1 required
WorkflowRandomCohortStepBranch
object
A cohort branch in an experiment step.
4 properties
1 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Knock publishes across the network.
