Deployments

How your Bash is set up, in versions: apply a whole vestra.yaml, promote, roll back, and the interview that drafts the file.

Send Authorization: Bearer vk_test_... on every call. Every route of Deployments.

POST/v1/deploymentsCreate one on base 'bash'.

It starts with a draft version.

Your API key, scope setup or all. On the card: deploy. Over HTTP it is made from the contract: fill in every value.

Request6 fields

Headers

Idempotency-KeystringSend the same key to retry this call safely for 24 hours.

Type: string

Body

namestringrequiredIts name, as people read it, 1 to 120 characters.

Limits: 1 to 120 characters.
Example: Trip rescue

slugstringIts name in URLs and refs: lowercase letters, digits and dashes, up to 63. Absent: made from name.

Example: trip-rescue

descriptionstringWhat it is for, up to 2,000 characters.

Limits: At most 2000 characters.

manifestmap of anyThe version's settings as a manifest: instructions, language, model, mcp_servers, mcp_tool_policy, apps, approvals, memory, notebooks, skills, tools, environment, browser and limits. A field left out takes its default.

Type: map of any

notestringA note on this version, up to 500 characters, such as what changed.

Limits: At most 500 characters.
Example: Adds the refund tool.

Answers 20111 fields

idstringThe deployment's id.

Example: dep_8f2k

object"deployment"Always deployment.

Type: "deployment"

namestringIts name, as people read it.

Type: string

slugstringIts name in URLs and refs: send it where a route takes {deployment_id}.

Example: trip-rescue

descriptionstringWhat it is for; empty when none was given.

Type: string

base"bash"What it is built on: always bash.

Type: "bash"

status"active" | "archived"active, or archived (put away: no new conversation or version reaches it).

Type: "active" | "archived"

draft_versionintegerThe version test keys run. A new save moves it there; a promote with a test key moves it to the version named, older ones included.

Type: integer

live_versioninteger | nullThe version live keys run; null until one is promoted.

Type: integer | null

created_atstringWhen it was made, as an ISO 8601 date and time in UTC.

Type: string

updated_atstringWhen it last changed, as an ISO 8601 date and time in UTC.

Type: string

HTTP

No sample in your language for this route, so here it is over HTTP.

curl -X POST "$VESTRA_BASE_URL/v1/deployments" \  -H "Authorization: Bearer $VESTRA_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "name": "Trip rescue"  }'