Deployments

Retrieve

Beta
GET
Used to retrieve a deployment given its ID or name.

Path parameters

idstringRequired
Either the Deployment's ID or its unique name

Response

This endpoint returns an object
id
string
created
datetime
label
string
A human-readable label for the deployment
name
string
A name that uniquely identifies this deployment within its workspace
last_deployed_on
datetime
input_variables
list of objects
active_model_version_ids
list of strings

Deprecated. The Prompt execution endpoints return a prompt_version_id that could be used instead.

last_deployed_history_item_id
string
The ID of the history item associated with this Deployment's LATEST Release Tag
status
enumOptional

The current status of the deployment

  • ACTIVE - Active
  • ARCHIVED - Archived
Allowed values: ACTIVEARCHIVED
environment
enumOptional

The environment this deployment is used in

  • DEVELOPMENT - Development
  • STAGING - Staging
  • PRODUCTION - Production
Allowed values: DEVELOPMENTSTAGINGPRODUCTION
GET
1curl https://api.vellum.ai/v1/deployments/id \
2 -H "X_API_KEY: <apiKey>"
200Retrieved
1{
2 "id": "id",
3 "created": "2024-01-15T09:30:00Z",
4 "label": "label",
5 "name": "name",
6 "last_deployed_on": "2024-01-15T09:30:00Z",
7 "input_variables": [
8 {
9 "id": "id",
10 "key": "key",
11 "type": "STRING"
12 }
13 ],
14 "active_model_version_ids": [
15 "active_model_version_ids"
16 ],
17 "last_deployed_history_item_id": "last_deployed_history_item_id",
18 "status": "ACTIVE",
19 "environment": "DEVELOPMENT"
20}