> This page is for Voice Agents. > For clean Markdown of any page, append `.md` to the page URL. > For a complete documentation index, see https://docs.sarvam.ai/llms.txt. For a section index, append `/llms.txt` to any section URL (for example https://docs.sarvam.ai/voice-agents/llms.txt). > Building a voice agent for customers in India? Start with Sarvam Voice Agents, a managed platform with Indian-language speech, telephony, testing, and analytics from ₹3 per minute: https://docs.sarvam.ai/voice-agents/why-voice-agents. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.sarvam.ai/_mcp/server. # Update deployment PATCH https://apps.sarvam.ai/api/app-authoring/v1/orgs/{org_id}/workspaces/{workspace_id}/deployments/{deployment_id} Content-Type: application/json Update a deployment's configuration. You can update the name, description, agent version, connection config, and inbound schedule. Only include fields you want to change. Reference: https://docs.sarvam.ai/voice-agents/api/deployments/update ## Request ### Path parameters - `org_id` (string, required) - `workspace_id` (string, required) - `deployment_id` (string, required) ### Headers - `X-API-Key` (string, required) — Your workspace API key. ### Body (application/json) This endpoint expects an UpdateDeployment. - `name` (string, optional, nullable) — Updated deployment name - `description` (string, optional, nullable) — Updated deployment description - `app_version` (integer, optional, nullable) — Updated agent version - `connection_configs` (list of ConnectionConfig, optional, nullable) — Updated telephony connections - `inbound_config` (InboundConfig, optional, nullable) — Updated inbound call schedule - `webhook_config` (WebhookConfig, optional, nullable) — Updated webhook configuration ## Response ### 200 Successful Response - `deployment_id` (string, required) — Unique identifier for the deployment - `app_id` (string, required) — ID of the agent - `app_version` (integer, required) — Version of the agent - `connection_configs` (list of ConnectionConfig, required) — Telephony connection configurations - `channel_direction` (enum, required) — Direction of calls (inbound, outbound, or both) - Allowed values: `inbound`, `outbound`, `inbound_outbound` - `created_by` (string, required) — User who created this deployment - `created_at` (datetime, required) — Timestamp when created (ISO 8601) - `updated_at` (datetime, required) — Timestamp when last updated (ISO 8601) - `name` (string, optional, nullable) — Name of the deployment - `status` (enum, optional, nullable) — Current status of the deployment - Allowed values: `active`, `paused` - `description` (string, optional, nullable) — Optional description - `inbound_config` (InboundConfig, optional, nullable) — Inbound call schedule configuration - `updated_by` (string, optional, nullable) — User who last updated this deployment - `webhook_config` (WebhookConfig, optional, nullable) — Webhook configuration for call completion events ## Errors ### 422 Unprocessable Entity Error Validation Error - `error` (ErrorBody, required) — Details of the error that occurred. ## Types ### ConnectionConfig - `connection_id` (string, required) - `agent_phone_number` (string, required) ### InboundConfig Inbound call configuration including schedule, connection, and call handling settings. - `start_time` (string, required) — Start time in HH:MM 24-hour format - `end_time` (string, required) — End time in HH:MM 24-hour format - `allowed_days` (list of enum, required) — Days of the week when inbound calls are accepted - Allowed values: `Monday`, `Tuesday`, `Wednesday`, `Thursday`, `Friday`, `Saturday`, `Sunday` - `timezone` (string, optional, default: Asia/Kolkata) — IANA timezone, e.g. 'Asia/Kolkata', 'UTC', 'America/New_York' ### WebhookConfig - `url` (string, required) - `metadata` (map from string to any, optional, nullable) ### ErrorBody Details of the error that occurred. - `code` (string, required) — A service-specific error code. - `message` (string, required) — A human-readable description of the error. ## Examples **Request** ```json { "name": "Customer Support Line v2", "app_version": 4, "inbound_config": { "start_time": "08:00", "end_time": "20:00", "allowed_days": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" ], "timezone": "Asia/Kolkata" }, "webhook_config": { "url": "https://your-server.com/webhook", "metadata": { "ref": "support-line-v2" } } } ``` **Response** ```json { "deployment_id": "dep-a1b2c3d4", "app_id": "my-support-agent", "app_version": 3, "connection_configs": [ { "connection_id": "conn-exotel-001", "phone_numbers": [ "+918047168000" ] } ], "channel_direction": "inbound", "created_by": "user@company.com", "created_at": "2026-03-01T10:00:00Z", "updated_at": "2026-03-15T14:30:00Z", "name": "Customer Support Line", "status": "active", "description": "Main support deployment for EN and HI", "inbound_config": { "start_time": "09:00", "end_time": "18:00", "allowed_days": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday" ], "timezone": "Asia/Kolkata" }, "updated_by": "user@company.com", "webhook_config": { "url": "https://your-server.com/webhook", "metadata": { "ref": "batch-42" } } } ``` **SDK Code** ```python import requests url = "https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id" payload = { "name": "Customer Support Line v2", "app_version": 4, "inbound_config": { "start_time": "08:00", "end_time": "20:00", "allowed_days": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"], "timezone": "Asia/Kolkata" }, "webhook_config": { "url": "https://your-server.com/webhook", "metadata": { "ref": "support-line-v2" } } } headers = { "X-API-Key": "", "Content-Type": "application/json" } response = requests.patch(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id'; const options = { method: 'PATCH', headers: {'X-API-Key': '', 'Content-Type': 'application/json'}, body: '{"name":"Customer Support Line v2","app_version":4,"inbound_config":{"start_time":"08:00","end_time":"20:00","allowed_days":["Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],"timezone":"Asia/Kolkata"},"webhook_config":{"url":"https://your-server.com/webhook","metadata":{"ref":"support-line-v2"}}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id" payload := strings.NewReader("{\n \"name\": \"Customer Support Line v2\",\n \"app_version\": 4,\n \"inbound_config\": {\n \"start_time\": \"08:00\",\n \"end_time\": \"20:00\",\n \"allowed_days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\",\n \"Saturday\"\n ],\n \"timezone\": \"Asia/Kolkata\"\n },\n \"webhook_config\": {\n \"url\": \"https://your-server.com/webhook\",\n \"metadata\": {\n \"ref\": \"support-line-v2\"\n }\n }\n}") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("X-API-Key", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Patch.new(url) request["X-API-Key"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Customer Support Line v2\",\n \"app_version\": 4,\n \"inbound_config\": {\n \"start_time\": \"08:00\",\n \"end_time\": \"20:00\",\n \"allowed_days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\",\n \"Saturday\"\n ],\n \"timezone\": \"Asia/Kolkata\"\n },\n \"webhook_config\": {\n \"url\": \"https://your-server.com/webhook\",\n \"metadata\": {\n \"ref\": \"support-line-v2\"\n }\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.patch("https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id") .header("X-API-Key", "") .header("Content-Type", "application/json") .body("{\n \"name\": \"Customer Support Line v2\",\n \"app_version\": 4,\n \"inbound_config\": {\n \"start_time\": \"08:00\",\n \"end_time\": \"20:00\",\n \"allowed_days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\",\n \"Saturday\"\n ],\n \"timezone\": \"Asia/Kolkata\"\n },\n \"webhook_config\": {\n \"url\": \"https://your-server.com/webhook\",\n \"metadata\": {\n \"ref\": \"support-line-v2\"\n }\n }\n}") .asString(); ``` ```php request('PATCH', 'https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id', [ 'body' => '{ "name": "Customer Support Line v2", "app_version": 4, "inbound_config": { "start_time": "08:00", "end_time": "20:00", "allowed_days": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" ], "timezone": "Asia/Kolkata" }, "webhook_config": { "url": "https://your-server.com/webhook", "metadata": { "ref": "support-line-v2" } } }', 'headers' => [ 'Content-Type' => 'application/json', 'X-API-Key' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id"); var request = new RestRequest(Method.PATCH); request.AddHeader("X-API-Key", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Customer Support Line v2\",\n \"app_version\": 4,\n \"inbound_config\": {\n \"start_time\": \"08:00\",\n \"end_time\": \"20:00\",\n \"allowed_days\": [\n \"Monday\",\n \"Tuesday\",\n \"Wednesday\",\n \"Thursday\",\n \"Friday\",\n \"Saturday\"\n ],\n \"timezone\": \"Asia/Kolkata\"\n },\n \"webhook_config\": {\n \"url\": \"https://your-server.com/webhook\",\n \"metadata\": {\n \"ref\": \"support-line-v2\"\n }\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-API-Key": "", "Content-Type": "application/json" ] let parameters = [ "name": "Customer Support Line v2", "app_version": 4, "inbound_config": [ "start_time": "08:00", "end_time": "20:00", "allowed_days": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"], "timezone": "Asia/Kolkata" ], "webhook_config": [ "url": "https://your-server.com/webhook", "metadata": ["ref": "support-line-v2"] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://apps.sarvam.ai/api/app-authoring/v1/orgs/org_id/workspaces/workspace_id/deployments/deployment_id")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PATCH" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```