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

The subpackage_deployments API from Vellum AI — 7 operation(s) for subpackage_deployments.

Vellum AI subpackage_deployments API is one of 16 APIs that Vellum AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 8 operations across 7 paths, and defines 110 schemas. It is described by OpenAPI 3.1.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.

8 operations 7 paths 110 schemas 6 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 1

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

Paths & Operations 8

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

subpackage_deployments 8
POST
/v1/deployments/provider-payload
Retrieve Provider Payload
retrieve-provider-payload 2 params body → 200400403404500
GET
/v1/deployments
List
list 6 params → 200
GET
/v1/deployments/{id}
Retrieve
retrieve 3 params → 200
GET
/v1/deployments/{id}/releases/{release_id_or_release_tag}
Retrieve Prompt Deployment Release
retrieve-prompt-deployment-release 4 params → 200
GET
/v1/deployments/{id}/release-tags/{name}
Retrieve Deployment Release Tag
retrieve-deployment-release-tag 4 params → 200
PATCH
/v1/deployments/{id}/release-tags/{name}
Update Deployment Release Tag
update-deployment-release-tag 4 params body → 200
GET
/v1/deployments/{id}/release-tags
List Deployment Release Tags
list-deployment-release-tags 7 params → 200
GET
/v1/deployments/{id}/history/{history_id_or_release_tag}
Deployment History Item Retrieve
deployment-history-item-retrieve 4 params → 200

Schemas 110

The contract defines 110 schemas that model the data the API accepts and returns. The most detailed are DeploymentRead (11 properties), SlimDeploymentRead (9 properties), PromptDeploymentRelease (9 properties), VellumVariable (7 properties). Each schema is shown below with its type and property counts.

ArrayChatMessageContentRequest
object
A list of chat message content items.
2 properties 2 required
ErrorVellumValue
object
A value representing an Error.
2 properties 2 required
EntityStatus
string
ACTIVE - Active ARCHIVED - Archived PENDINGDELETION - Pending Deletion
PdfEnum
string
ReleaseReviewReviewer
object
2 properties 1 required
PatchedDeploymentReleaseTagUpdateRequest
object
1 property
SearchResultsVellumValue
object
A value representing Search Results.
2 properties 2 required
ChatHistoryVellumValue
object
A value representing Chat History.
2 properties 2 required
ArrayVellumValue
object
A value representing an array of Vellum variable values.
2 properties 2 required
VellumVariableType
string
STRING - STRING NUMBER - NUMBER JSON - JSON CHATHISTORY - CHATHISTORY SEARCHRESULTS - SEARCHRESULTS ERROR - ERROR ARRAY - ARRAY FUNCTIONCALL - FUNCTIONCALL AUD…
CompilePromptMeta
object
The subset of the metadata tracked by Vellum during Prompt Deployment compilation that the request opted into with expandmeta.
3 properties
VideoInputRequest
object
A user input representing a Vellum Video value
3 properties 3 required
V1DeploymentsIdReleaseTagsGetParametersSource
string
VideoEnum
string
DocumentChatMessageContentRequest
object
A document value that is used in a chat message.
2 properties 2 required
VideoChatMessageContent
object
A video value that is used in a chat message.
2 properties 2 required
FunctionCallChatMessageContentValueRequest
object
The final resolved function call value.
3 properties 2 required
PromptVersionBuildConfig
SearchResultMeta
object
1 property
ReleaseReviewState
string
APPROVED - Approved CHANGESREQUESTED - Changes Requested COMMENTED - Commented
VideoChatMessageContentRequest
object
A video value that is used in a chat message.
2 properties 2 required
AudioVellumValue
object
A base Vellum primitive value representing audio.
2 properties 2 required
ArrayChatMessageContent
object
A list of chat message content items.
2 properties 2 required
StringInputRequest
object
A user input representing a string value
3 properties 3 required
ChatMessageRole
string
SYSTEM - System ASSISTANT - Assistant USER - User FUNCTION - Function
NumberEnum
string
ReleaseTagRelease
object
2 properties 2 required
ArrayChatMessageContentItemRequest
StringChatMessageContentRequest
object
A string value that is used in a chat message.
2 properties 2 required
VellumImage
object
2 properties 1 required
StringVellumValue
object
A value representing a string.
2 properties 2 required
SlimReleaseReview
object
4 properties 4 required
ExecutePromptApiErrorResponse
object
2 properties 1 required
PromptDeploymentReleasePromptVersion
object
3 properties 3 required
DeploymentProviderPayloadResponse
object
2 properties 2 required
VellumDocumentRequest
object
2 properties 1 required
ChatHistoryInputRequest
object
A user input representing a list of chat messages
3 properties 3 required
VellumDocument
object
2 properties 1 required
PromptDeploymentInputRequest
VideoVellumValue
object
A base Vellum primitive value representing a video.
2 properties 2 required
PdfSearchResultMetaSource
object
The source of a search result from a PDF document.
3 properties 3 required
AudioInputRequest
object
A user input representing a Vellum Audio value
3 properties 3 required
PromptDeploymentRelease
object
9 properties 8 required
ImageChatMessageContentRequest
object
An image value that is used in a chat message.
2 properties 2 required
DeploymentProviderPayloadResponsePayload
VellumVariableExtensions
object
A set of fields with additional properties for use in Vellum Variables.
3 properties
AudioEnum
string
DeploymentReleaseTagDeploymentHistoryItem
object
2 properties 2 required
ImageEnum
string
FunctionCall
object
The final resolved function call value.
3 properties 2 required
JsonVellumValue
object
A value representing a JSON object.
2 properties 2 required
StringChatMessageContent
object
A string value that is used in a chat message.
2 properties 2 required
VellumError
object
3 properties 2 required
EnvironmentEnum
string
ReleaseReleaseTag
object
2 properties 2 required
FunctionCallChatMessageContentValue
object
The final resolved function call value.
3 properties 2 required
DocumentChatMessageContent
object
A document value that is used in a chat message.
2 properties 2 required
FunctionCallChatMessageContentRequest
object
A function call value that is used in a chat message.
2 properties 2 required
PaginatedSlimDeploymentReadList
object
4 properties
ReleaseEnvironment
object
3 properties 3 required
ChatMessageContent
CompilePromptDeploymentExpandMetaRequest
object
3 properties
VellumVideoRequest
object
2 properties 1 required
StringEnum
string
DocumentVellumValue
object
A base Vellum primitive value representing a document.
2 properties 2 required
NumberVellumValue
object
A value representing a number.
2 properties 2 required
ImageInputRequest
object
A user input representing a Vellum Image value
3 properties 3 required
ThinkingEnum
string
FunctionCallVellumValue
object
A value representing a Function Call.
2 properties 2 required
VellumVariable
object
7 properties 3 required
AudioChatMessageContentRequest
object
An audio value that is used in a chat message.
2 properties 2 required
ImageVellumValue
object
A base Vellum primitive value representing an image.
2 properties 2 required
JsonEnum
string
V1DeploymentsGetParametersStatus
string
ReleaseTagSource
string
SYSTEM - System USER - User
FunctionCallEnum
string
SearchResultsEnum
string
VellumAudioRequest
object
2 properties 1 required
ArrayEnum
string
VellumErrorCodeEnum
string
INVALIDREQUEST - INVALIDREQUEST INVALIDINPUTS - INVALIDINPUTS PROVIDERERROR - PROVIDERERROR PROVIDERCREDENTIALSUNAVAILABLE - PROVIDERCREDENTIALSUNAVAILABLE INT…
VellumVideo
object
2 properties 1 required
ErrorEnum
string
DeploymentHistoryItem
object
7 properties 6 required
ChatMessageRequest
object
5 properties 1 required
DocumentInputRequest
object
A user input representing a Vellum Document value
3 properties 3 required
ChatMessage
object
5 properties 1 required
ReleaseCreatedBy
object
3 properties 2 required
SandboxEnum
string
AudioChatMessageContent
object
An audio value that is used in a chat message.
2 properties 2 required
DeploymentProviderPayloadRequest
object
5 properties 1 required
DocumentEnum
string
VellumImageRequest
object
2 properties 1 required
PromptDeploymentReleasePromptDeployment
object
2 properties 2 required
ChatHistoryEnum
string
FunctionCallChatMessageContent
object
A function call value that is used in a chat message.
2 properties 2 required
ImageChatMessageContent
object
An image value that is used in a chat message.
2 properties 2 required
SearchResult
object
5 properties 4 required
JSONInputRequest
object
A user input representing a JSON object
3 properties 3 required
PaginatedDeploymentReleaseTagReadList
object
4 properties
SlimDeploymentRead
object
A subset of a Prompt Deployment's full details.
9 properties 6 required
ChatMessageContentRequest
DeploymentReleaseTagRead
object
4 properties 4 required
ThinkingVellumValue
object
A value representing Thinking mode output.
2 properties 2 required
VellumAudio
object
2 properties 1 required
SearchResultDocument
object
4 properties 1 required
SearchResultMetaSource
VellumValue
ArrayChatMessageContentItem
PromptVersionBuildConfigSandbox
object
4 properties 4 required
DeploymentRead
object
A Prompt Deployment's full details.
11 properties 8 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Vellum AI publishes across the network.

Vellum LLM Platform API
Vellum AI Default API
Vellum AI subpackage_documentIndexes API
Vellum AI subpackage_documents API
Vellum AI subpackage_events API
Vellum AI subpackage_folderEntities API
Vellum AI subpackage_sandboxes API
Vellum AI subpackage_testSuiteRuns API
Vellum AI subpackage_testSuites API
Vellum AI subpackage_uploadedFiles API
Vellum AI subpackage_workflowDeployments API
Vellum AI subpackage_workflowExecutions API
Where this information came from

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