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

The subpackage_sandboxes API from Vellum AI — 3 operation(s) for subpackage_sandboxes.

Vellum AI Subpackage Sandboxes API is one of 23 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 3 operations across 3 paths, and defines 93 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.

3 operations 3 paths 93 schemas 1 DELETE2 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 Sandboxes API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-KEY (default).

Paths & Operations 3

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

subpackage_sandboxes 3
POST
/v1/sandboxes/{id}/prompts/{prompt_variant_id}/deploy
Deploy Prompt
deploy-prompt 4 params body → 200
POST
/v1/sandboxes/{id}/scenarios
Upsert Sandbox Scenario
upsert-sandbox-scenario 3 params body → 200
DELETE
/v1/sandboxes/{id}/scenarios/{scenario_id}
Delete Sandbox Scenario
delete-sandbox-scenario 4 params → 204

Schemas 93

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

DocumentChatMessageContent
object
A document value that is used in a chat message.
2 properties 2 required
ArrayChatMessageContent
object
A list of chat message content items.
2 properties 2 required
NamedScenarioInputAudioVariableValueRequest
object
3 properties 3 required
ChatHistoryVellumValue
object
A value representing Chat History.
2 properties 2 required
sandboxes_delete_sandbox_scenario_Response_204
object
Empty response body
VideoChatMessageContentRequest
object
A video value that is used in a chat message.
2 properties 2 required
ScenarioInputJsonVariableValue
object
Prompt Sandbox Scenario input value that is of type JSON
3 properties 3 required
ScenarioInput
VellumVariable
object
7 properties 3 required
PdfEnum
string
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
NamedScenarioInputStringVariableValueRequest
object
Named Prompt Sandbox Scenario input value that is of type STRING
3 properties 3 required
SearchResultsEnum
string
VellumImage
object
2 properties 1 required
AudioChatMessageContentRequest
object
An audio value that is used in a chat message.
2 properties 2 required
DeploymentRead
object
A Prompt Deployment's full details.
11 properties 8 required
NamedScenarioInputChatHistoryVariableValueRequest
object
Named Prompt Sandbox Scenario input value that is of type CHATHISTORY
3 properties 3 required
EnvironmentEnum
string
SandboxScenario
object
Sandbox Scenario
3 properties 2 required
NamedScenarioInputRequest
StringChatMessageContentRequest
object
A string value that is used in a chat message.
2 properties 2 required
VellumError
object
3 properties 2 required
ErrorVellumValue
object
A value representing an Error.
2 properties 2 required
NamedScenarioInputJsonVariableValueRequest
object
Named Prompt Sandbox Scenario input value that is of type JSON
3 properties 3 required
NamedScenarioInputVideoVariableValueRequest
object
3 properties 3 required
SearchResult
object
5 properties 4 required
ThinkingVellumValue
object
A value representing Thinking mode output.
2 properties 2 required
NumberEnum
string
FunctionCallEnum
string
VellumValue
ArrayChatMessageContentItem
VellumErrorCodeEnum
string
INVALIDREQUEST - INVALIDREQUEST INVALIDINPUTS - INVALIDINPUTS PROVIDERERROR - PROVIDERERROR PROVIDERCREDENTIALSUNAVAILABLE - PROVIDERCREDENTIALSUNAVAILABLE INT…
SearchResultsVellumValue
object
A value representing Search Results.
2 properties 2 required
ArrayChatMessageContentItemRequest
VellumVariableType
string
STRING - STRING NUMBER - NUMBER JSON - JSON CHATHISTORY - CHATHISTORY SEARCHRESULTS - SEARCHRESULTS ERROR - ERROR ARRAY - ARRAY FUNCTIONCALL - FUNCTIONCALL AUD…
VellumVariableExtensions
object
A set of fields with additional properties for use in Vellum Variables.
3 properties
ScenarioInputStringVariableValue
object
Prompt Sandbox Scenario input value that is of type STRING
3 properties 3 required
NamedScenarioInputImageVariableValueRequest
object
3 properties 3 required
VellumVideo
object
2 properties 1 required
PdfSearchResultMetaSource
object
The source of a search result from a PDF document.
3 properties 3 required
ImageChatMessageContentRequest
object
An image value that is used in a chat message.
2 properties 2 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
VellumImageRequest
object
2 properties 1 required
SearchResultDocument
object
4 properties 1 required
UpsertSandboxScenarioRequest
object
3 properties 1 required
DeploySandboxPromptRequest
object
5 properties
DocumentEnum
string
ChatMessageContentRequest
FunctionCallChatMessageContent
object
A function call value that is used in a chat message.
2 properties 2 required
ChatMessageRequest
object
5 properties 1 required
ChatHistoryEnum
string
StringVellumValue
object
A value representing a string.
2 properties 2 required
ErrorEnum
string
FunctionCallChatMessageContentValueRequest
object
The final resolved function call value.
3 properties 2 required
SearchResultMetaSource
ScenarioInputImageVariableValue
object
3 properties 3 required
ArrayEnum
string
FunctionCall
object
The final resolved function call value.
3 properties 2 required
DocumentVellumValue
object
A base Vellum primitive value representing a document.
2 properties 2 required
JsonVellumValue
object
A value representing a JSON object.
2 properties 2 required
ScenarioInputAudioVariableValue
object
3 properties 3 required
StringEnum
string
VellumAudio
object
2 properties 1 required
ImageEnum
string
VellumVideoRequest
object
2 properties 1 required
DocumentChatMessageContentRequest
object
A document value that is used in a chat message.
2 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
ChatMessageRole
string
SYSTEM - System ASSISTANT - Assistant USER - User FUNCTION - Function
FunctionCallChatMessageContentRequest
object
A function call value that is used in a chat message.
2 properties 2 required
ChatMessageContent
ScenarioInputDocumentVariableValue
object
3 properties 3 required
NumberVellumValue
object
A value representing a number.
2 properties 2 required
JsonEnum
string
VideoEnum
string
ImageVellumValue
object
A base Vellum primitive value representing an image.
2 properties 2 required
ScenarioInputVideoVariableValue
object
3 properties 3 required
VellumDocumentRequest
object
2 properties 1 required
ChatMessage
object
5 properties 1 required
SearchResultMeta
object
1 property
ArrayChatMessageContentRequest
object
A list of chat message content items.
2 properties 2 required
NamedScenarioInputDocumentVariableValueRequest
object
3 properties 3 required
FunctionCallVellumValue
object
A value representing a Function Call.
2 properties 2 required
VellumAudioRequest
object
2 properties 1 required
ScenarioInputChatHistoryVariableValue
object
Prompt Sandbox Scenario input value that is of type CHATHISTORY
3 properties 3 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
ThinkingEnum
string
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-sandboxes-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 Test Suite Runs API
Vellum AI Subpackage Test Suites API
Vellum AI Subpackage Uploaded Files API
Vellum AI Subpackage Workflow Deployments 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 Sandboxes 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.