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

Vellum AI Subpackage Workflow Deployments API

The subpackage_workflowDeployments API from Vellum AI — 10 operation(s) for subpackage_workflowdeployments.

Vellum AI Subpackage Workflow Deployments API is one of 23 APIs that Vellum AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include subpackage_workflowDeployments. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 11 operations across 10 paths, and defines 206 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 3 base URLs: https://predict.vellum.ai, https://api.vellum.ai, https://documents.vellum.ai.

11 operations 10 paths 206 schemas 9 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.vellum.ai
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Vellum AI Subpackage Workflow Deployments API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-KEY (default).

Paths & Operations 11

Across 10 paths, the API surfaces 11 operations — 9 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

subpackage_workflowDeployments 11
POST
/v1/workflow-deployments/{id}/execute-stream
Execute Stream
execute-stream 3 params body → 200400404500
GET
/v1/workflow-deployments
List
list 9 params → 200
GET
/v1/workflow-deployments/{id}/releases
List Workflow Deployment Releases
list-workflow-deployment-releases 6 params → 200
GET
/v1/workflow-deployments/{id}
Retrieve
retrieve 3 params → 200
GET
/v1/workflow-deployments/{id}/releases/{release_id_or_release_tag}
Retrieve Workflow Deployment Release
retrieve-workflow-deployment-release 4 params → 200
GET
/v1/workflow-deployments/{id}/release-tags/{name}
Retrieve Workflow Release Tag
retrieve-workflow-release-tag 4 params → 200
PATCH
/v1/workflow-deployments/{id}/release-tags/{name}
Update Workflow Release Tag
update-workflow-release-tag 4 params body → 200
GET
/v1/workflow-deployments/{id}/release-tags
List Workflow Release Tags
list-workflow-release-tags 7 params → 200
GET
/v1/workflow-deployments/{id}/history/{history_id_or_release_tag}
Workflow Deployment History Item Retrieve
workflow-deployment-history-item-retrieve 4 params → 200
GET
/v1/workflow-deployments/{id}/execution-events
List Workflow Deployment Event Executions
list-workflow-deployment-event-executions 7 params → 200
GET
/v1/workflow-deployments/{id}/execution-events/{execution_id}
Workflow Deployment Event Execution
workflow-deployment-event-execution 4 params → 200400404421

Schemas 206

The contract defines 206 schemas that model the data the API accepts and returns. The most detailed are WorkflowDeploymentRead (12 properties), WorkflowDeploymentParentContext (12 properties), WorkflowEventExecutionRead (12 properties), PromptDeploymentParentContext (12 properties). Each schema is shown below with its type and property counts.

UpdateActiveWorkspaceResponse
object
3 properties 2 required
WorkflowReleaseTagRead
object
4 properties 4 required
DocumentChatMessageContent
object
A document value that is used in a chat message.
2 properties 2 required
WorkflowExecutionFulfilledBody
object
5 properties 2 required
ArrayChatMessageContent
object
A list of chat message content items.
2 properties 2 required
WorkflowExecutionPausedEvent
object
9 properties 6 required
ChatHistoryVellumValue
object
A value representing Chat History.
2 properties 2 required
PromptReleaseTagEnum
string
NodeExecutionPausedBody
object
1 property 1 required
VellumVariable
object
7 properties 3 required
ExecutionChatHistoryVellumValue
object
A value representing Chat History.
4 properties 4 required
PdfEnum
string
NodeExecutionLogBody
object
4 properties 3 required
NodeExecutionResumedEvent
object
9 properties 6 required
V1WorkflowDeploymentsGetParametersStatus
string
WorkflowEventErrorRawData
AudioEnum
string
ImageChatMessageContent
object
An image value that is used in a chat message.
2 properties 2 required
VideoVellumValue
object
A base Vellum primitive value representing a video.
2 properties 2 required
WorkflowModelProviderDependency
object
4 properties 3 required
WorkflowExecutionSnapshottedBody
object
3 properties 2 required
SlimWorkflowExecutionRead
object
10 properties 10 required
SearchResultsEnum
string
VellumImage
object
2 properties 1 required
ParentContext
WorkflowDeploymentRelease
object
9 properties 8 required
workflow.execution.fulfilledEnum
string
SpanLinkTypeEnum
string
TRIGGEREDBY - TRIGGEREDBY PREVIOUSSPAN - PREVIOUSSPAN ROOTSPAN - ROOTSPAN
workflow.execution.snapshottedEnum
string
SlimReleaseReview
object
4 properties 4 required
EnvironmentEnum
string
WorkflowDeploymentReleaseWorkflowVersion
object
The workflow version associated with a workflow deployment release.
4 properties 3 required
ExecutionErrorVellumValue
object
A value representing an Error.
4 properties 4 required
WorkflowExecutionRejectedEvent
object
9 properties 6 required
ReleaseTagRelease
object
2 properties 2 required
NodeExecutionLogEvent
object
9 properties 6 required
MLModelUsage
object
7 properties
node.execution.initiatedEnum
string
node.execution.fulfilledEnum
string
PaginatedWorkflowReleaseTagReadList
object
4 properties
WorkflowExecutionSnapshottedEvent
object
9 properties 6 required
ExecutionStringVellumValue
object
A value representing a string.
4 properties 4 required
ErrorDetailResponse
object
1 property 1 required
ModelProviderEnum
string
VellumError
object
3 properties 2 required
WorkflowExecutionViewOnlineEvalMetricResult
object
3 properties 3 required
ExecutionDocumentVellumValue
object
A base Vellum primitive value representing a document.
4 properties 4 required
WorkflowEventExecutionRead
object
12 properties 11 required
MLModelUsageWrapper
object
2 properties 2 required
ErrorVellumValue
object
A value representing an Error.
2 properties 2 required
NodeExecutionSpan
object
8 properties 7 required
NodeExecutionFulfilledEvent
object
9 properties 6 required
NodeExecutionPausedEvent
object
9 properties 6 required
SearchResult
object
5 properties 4 required
SeverityEnum
string
DEBUG - DEBUG INFO - INFO WARNING - WARNING ERROR - ERROR
WorkflowReleaseTagEnum
string
WorkflowExecutionUsageResult
object
3 properties
ReleaseReviewReviewer
object
2 properties 1 required
VellumSdkError
object
3 properties 2 required
workflow.execution.streamingEnum
string
WorkflowExecutionActual
object
4 properties 3 required
ExecutionArrayVellumValue
object
A value representing an array of Vellum variable values.
4 properties 4 required
WorkflowExecutionSpan
object
8 properties 7 required
ThinkingVellumValue
object
A value representing Thinking mode output.
2 properties 2 required
WorkflowReleaseTagWorkflowDeploymentHistoryItem
object
2 properties 2 required
SlimWorkflowDeployment
object
A subset of a Workflow Deployment's full details.
10 properties 7 required
WorkflowEvent
WorkflowExecutionInitiatedEvent
object
9 properties 6 required
ScheduledTriggerContext
object
5 properties 2 required
NumberEnum
string
ReleaseReviewState
string
APPROVED - Approved CHANGESREQUESTED - Changes Requested COMMENTED - Commented
FunctionCallEnum
string
VellumValue
WorkflowSandboxParentContext
object
7 properties 5 required
NodeExecutionInitiatedBody
object
2 properties 2 required
ArrayChatMessageContentItem
ExecutionJsonVellumValue
object
A value representing a JSON object.
4 properties 4 required
VellumErrorCodeEnum
string
INVALIDREQUEST - INVALIDREQUEST INVALIDINPUTS - INVALIDINPUTS PROVIDERERROR - PROVIDERERROR PROVIDERCREDENTIALSUNAVAILABLE - PROVIDERCREDENTIALSUNAVAILABLE INT…
SearchResultsVellumValue
object
A value representing Search Results.
2 properties 2 required
IntegrationEnum
string
workflow.execution.resumedEnum
string
WorkflowDependency
ApiRequestEnum
string
node.execution.streamingEnum
string
VellumSpan
node.executionEnum
string
PatchedWorkflowReleaseTagUpdateRequest
object
1 property
VellumVariableType
string
STRING - STRING NUMBER - NUMBER JSON - JSON CHATHISTORY - CHATHISTORY SEARCHRESULTS - SEARCHRESULTS ERROR - ERROR ARRAY - ARRAY FUNCTIONCALL - FUNCTIONCALL AUD…
ReleaseReleaseTag
object
2 properties 2 required
VellumVariableExtensions
object
A set of fields with additional properties for use in Vellum Variables.
3 properties
WorkflowNodeEnum
string
node.execution.resumedEnum
string
ExecutionImageVellumValue
object
A base Vellum primitive value representing an image.
4 properties 4 required
ExecutionVellumValue
ReleaseTagSource
string
SYSTEM - System USER - User
VellumVideo
object
2 properties 1 required
PdfSearchResultMetaSource
object
The source of a search result from a PDF document.
3 properties 3 required
WorkflowIntegrationDependency
object
4 properties 3 required
WorkflowExecutionResumedEvent
object
9 properties 6 required
WorkflowDeploymentRead
object
A Workflow Deployment's full details.
12 properties 8 required
FunctionCallChatMessageContentValue
object
The final resolved function call value.
3 properties 2 required
VideoChatMessageContent
object
A video value that is used in a chat message.
2 properties 2 required
ApiVersionEnum
string
2024-10-25 - V20241025 2025-07-30 - V20250730
workflow.execution.initiatedEnum
string
ExecuteWorkflowDeploymentStreamRequest
object
The request to execute a Workflow Deployment stream.
6 properties
NodeExecutionInitiatedEvent
object
9 properties 6 required
SearchResultDocument
object
4 properties 1 required
node.execution.pausedEnum
string
DocumentEnum
string
WorkflowExecutionStreamingBody
object
2 properties 2 required
ExternalEnum
string
CodeResourceDefinition
object
The definition of a resource defined in code.
2 properties 2 required
FunctionCallChatMessageContent
object
A function call value that is used in a chat message.
2 properties 2 required
VellumSdkErrorCodeEnum
string
INVALIDWORKFLOW - INVALIDWORKFLOW INVALIDINPUTS - INVALIDINPUTS INVALIDOUTPUTS - INVALIDOUTPUTS INVALIDSTATE - INVALIDSTATE INVALIDCODE - INVALIDCODE INVALIDTE…
WorkflowEnum
string
WorkflowExecutionStreamingEvent
object
9 properties 6 required
ChatHistoryEnum
string
StringVellumValue
object
A value representing a string.
2 properties 2 required
WorkflowEventError
object
4 properties 2 required
BaseOutput
object
3 properties 1 required
WorkflowDeploymentParentContext
object
12 properties 8 required
ErrorEnum
string
WorkflowDeploymentEventExecutionsResponse
object
2 properties 2 required
workflow.execution.pausedEnum
string
workflow.execution.rejectedEnum
string
WorkflowExecutionInitiatedBody
object
3 properties 2 required
NodeExecutionResumedBody
object
1 property 1 required
SearchResultMetaSource
ApiActorTypeEnum
string
ANONYMOUS - ANONYMOUS WORKSPACEAPIKEY - WORKSPACEAPIKEY ENVIRONMENTAPIKEY - ENVIRONMENTAPIKEY JWT - JWT SERVICETOKEN - SERVICETOKEN
ArrayEnum
string
FunctionCall
object
The final resolved function call value.
3 properties 2 required
APIRequestParentContext
object
7 properties 2 required
DocumentVellumValue
object
A base Vellum primitive value representing a document.
2 properties 2 required
WorkflowDisplayIcon
object
Icon to be used alongside a Workflow
2 properties
JsonVellumValue
object
A value representing a JSON object.
2 properties 2 required
WorkflowExecutionPausedBody
object
2 properties 2 required
WorkflowParentContext
object
5 properties 3 required
WorkflowInitializationError
object
Workflow initialization error.
2 properties 2 required
StringEnum
string
ExecutionFunctionCallVellumValue
object
A value representing a Function Call.
4 properties 4 required
WorkflowExecutionUsageCalculationFulfilledBody
object
2 properties 2 required
NodeExecutionStreamingEvent
object
9 properties 6 required
MLModelHostingInterface
string
ANTHROPIC - Anthropic AWSBEDROCK - AWS Bedrock AZUREAIFOUNDRY - Azure AI Foundry AZUREOPENAI - Azure OpenAI BASETEN - BaseTen CEREBRAS - Cerebras COHERE - Cohe…
PaginatedSlimWorkflowDeploymentList
object
4 properties
ReleaseCreatedBy
object
3 properties 2 required
VellumSdkErrorRawData
VellumAudio
object
2 properties 1 required
NodeExecutionFulfilledBody
object
5 properties 2 required
ExecutionNumberVellumValue
object
A value representing a number.
4 properties 4 required
ImageEnum
string
node.execution.rejectedEnum
string
V1WorkflowDeploymentsIdReleaseTagsGetParametersSource
string
WorkflowExecutionUsageCalculationError
object
2 properties 2 required
ScheduledEnum
string
ExternalParentContext
object
4 properties 2 required
AudioChatMessageContent
object
An audio value that is used in a chat message.
2 properties 2 required
EntityStatus
string
ACTIVE - Active ARCHIVED - Archived PENDINGDELETION - Pending Deletion
VellumDocument
object
2 properties 1 required
NodeExecutionRejectedEvent
object
9 properties 6 required
ChatMessageRole
string
SYSTEM - System ASSISTANT - Assistant USER - User FUNCTION - Function
ChatMessageContent
PromptDeploymentParentContext
object
12 properties 8 required
WorkflowExecutionRejectedBody
object
3 properties 2 required
NumberVellumValue
object
A value representing a number.
2 properties 2 required
JsonEnum
string
ExternalInputDescriptor
object
4 properties 2 required
VideoEnum
string
ImageVellumValue
object
A base Vellum primitive value representing an image.
2 properties 2 required
ExecutionThinkingVellumValue
object
A value representing Thinking mode output.
4 properties 4 required
ExecutionSearchResultsVellumValue
object
A value representing Search Results.
4 properties 4 required
SpanLink
object
3 properties 3 required
WorkflowExecutionEventErrorCode
string
WORKFLOWINITIALIZATION - WORKFLOWINITIALIZATION WORKFLOWCANCELLED - WORKFLOWCANCELLED WORKFLOWTIMEOUT - WORKFLOWTIMEOUT PROVIDERCREDENTIALSUNAVAILABLE - PROVID…
ChatMessage
object
5 properties 1 required
ReleaseEnvironment
object
3 properties 3 required
VellumCodeResourceDefinition
object
4 properties 3 required
InvokedPort
object
1 property 1 required
SearchResultMeta
object
1 property
WorkflowError
WorkflowExecutionSpanAttributes
object
2 properties 2 required
WorkflowExecutionUsageCalculationErrorCodeEnum
string
UNKNOWN - UNKNOWN DEPENDENCIESFAILED - DEPENDENCIESFAILED NOUSAGECALCULATED - NOUSAGECALCULATED INTERNALSERVERERROR - INTERNALSERVERERROR
VellumNodeExecutionEvent
WorkflowDeploymentHistoryItem
object
8 properties 7 required
workflow.executionEnum
string
FunctionCallVellumValue
object
A value representing a Function Call.
2 properties 2 required
PaginatedWorkflowDeploymentReleaseList
object
4 properties
ExecutionAudioVellumValue
object
A base Vellum primitive value representing audio.
4 properties 4 required
IntegrationTriggerContext
object
5 properties 2 required
Price
object
2 properties 2 required
WorkflowExecutionResumedBody
object
1 property 1 required
ExecutionVideoVellumValue
object
A base Vellum primitive value representing a video.
4 properties 4 required
NodeExecutionStreamingBody
object
2 properties 2 required
NodeExecutionRejectedBody
object
3 properties 2 required
WorkflowSandboxEnum
string
node.execution.logEnum
string
WorkflowDeploymentDisplayData
object
Workflow Deployment display data
1 property
WorkflowExecutionFulfilledEvent
object
9 properties 6 required
NodeExecutionSpanAttributes
object
3 properties 2 required
WorkflowDeploymentReleaseWorkflowDeployment
object
2 properties 2 required
ArrayVellumValue
object
A value representing an array of Vellum variable values.
2 properties 2 required
AudioVellumValue
object
A base Vellum primitive value representing audio.
2 properties 2 required
UnitEnum
string
USD - USD
IntegrationName
string
SLACK - Slack NOTION - Notion GOOGLE - Google CALENDLY - Calendly CANVA - Canva CLICKUP - ClickUp CODA - Coda HUBSPOT - Hubspot INTERCOM - Intercom INSTAGRAM -…
NodeParentContext
object
5 properties 3 required
ThinkingEnum
string
VellumWorkflowExecutionEvent
StringChatMessageContent
object
A string value that is used in a chat message.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vellum-subpackage-workflowdeployments-api-openapi.yml Raw ↑

Other APIs Vellum AI publishes across the network.

Vellum LLM Platform API
Vellum AI Subpackage Deployments API
Vellum AI Subpackage Document Indexes API
Vellum AI Subpackage Documents API
Vellum AI Subpackage Events API
Vellum AI Subpackage Folder Entities API
Vellum AI Subpackage Sandboxes API
Vellum AI Subpackage Test Suite Runs API
Vellum AI Subpackage Test Suites API
Vellum AI Subpackage Uploaded Files API
Vellum AI Subpackage Workflow Executions API
Vellum AI Subpackage Workflows API
Where this information came from

This is an independent, third-party profile of Vellum AI Subpackage Workflow Deployments 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.