Make a version live

POST

agents

{agent_id}

versions

{version_id}

make-live

Make Version Live

curl --request POST \
  --url https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "version": 0,
  "version_id": "00000006-0000-4000-8000-000000000006",
  "is_published": true,
  "is_live": true,
  "label": "Renamed",
  "notes": null,
  "base_version": null,
  "document_revision": 2,
  "blocked_reasons": [],
  "inbound_phone": null,
  "inbound_whatsapp": null,
  "created_at": "2026-09-16T19:38:03.767024Z",
  "published_at": "2026-09-16T19:38:03.999783Z"
}

{
  "detail": "Invalid API key",
  "code": "UNAUTHORIZED"
}

{
  "detail": {
    "code": "validation_error",
    "message": "<string>",
    "errors": [
      {
        "field": "<string>",
        "message": "<string>",
        "type": "<string>"
      }
    ]
  },
  "code": "VALIDATION_ERROR"
}

{
  "code": "rate_limited"
}

This is the moment real callers reach the new configuration. Everything before it — creating, editing, publishing — is invisible to them.

Applies the version’s numbers at the same time: the phone and WhatsApp numbers it recorded start ringing it now. A number recorded on a version routes nothing until this call.

Rolling back

Make an older published version live again. Calls in progress finish on the version they started on — a version is resolved once, when the call begins.

When it is refused


`409 version_not_published`	Publish it first
`409 version_blocked`	`blocked_reasons` says why — e.g. it pins a model we no longer run
`409 number_in_use`	Its inbound number is answering for a different agent. Release it there first

Authorizations

Authorization

string

header

required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Path Parameters

agent_id

string

required

The agent's id, as GET /v1/agents returns it.

version_id

string

required

A version number (0, 1, 3) or a version uuid — both resolve. Prefer the number: it is the version's identity to you, it is what every version read returns, and it needs no lookup first.

Response

The version now answering calls.

One version in an agent's history.

Versions are identified by NUMBER: it is what every version read returns and what ?version= and /versions/{n} take.

version

integer

required

This version's number — what you pass in /versions/{n}.

version_id

string

required

This version's uuid. Published because POST /v1/calls pins a call with agent_version_id, which takes a uuid rather than a number.

is_published

boolean

required

True once frozen. Configuration can never be edited again; label and notes still can.

is_live

boolean

required

True if this is the version answering calls right now.

document_revision

integer

required

This version's edit counter. Send it as If-Match to make a write conditional.

created_at

string<date-time>

required

When this version was created (UTC, ISO 8601).

label

string | null

Short name for this version.

notes

string | null

Longer free text about this version.

base_version

integer | null

Which version this one was branched from, by NUMBER — null for the agent's first.

blocked_reasons

string[]

Why this version cannot be made live, if it cannot — e.g. it pins a retired model. Check it before offering a deploy button, so the button never fails on click.

inbound_phone

string | null

The phone number this version will answer on once it is made live. Inert until then.

inbound_whatsapp

string | null

The WhatsApp number this version will answer on once it is made live. Inert until then.

published_at

string<date-time> | null

When it was frozen. null while it is still a draft.

Make Version Live

curl --request POST \
  --url https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.vocily.ai/v1/agents/{agent_id}/versions/{version_id}/make-live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "version": 0,
  "version_id": "00000006-0000-4000-8000-000000000006",
  "is_published": true,
  "is_live": true,
  "label": "Renamed",
  "notes": null,
  "base_version": null,
  "document_revision": 2,
  "blocked_reasons": [],
  "inbound_phone": null,
  "inbound_whatsapp": null,
  "created_at": "2026-09-16T19:38:03.767024Z",
  "published_at": "2026-09-16T19:38:03.999783Z"
}

{
  "detail": "Invalid API key",
  "code": "UNAUTHORIZED"
}

{
  "detail": {
    "code": "validation_error",
    "message": "<string>",
    "errors": [
      {
        "field": "<string>",
        "message": "<string>",
        "type": "<string>"
      }
    ]
  },
  "code": "VALIDATION_ERROR"
}

{
  "code": "rate_limited"
}

Calls

Chats

Phone Numbers

Knowledge Bases

Files

Agents

Speech

Catalogues

Integrations

Custom Analysis

Memory

Widget

Webhooks

Make a version live

Rolling back

When it is refused

Authorizations

Path Parameters

Response