> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/switch-infrastructure/config-manager/llms.txt. > For full documentation content, see https://docs.nvidia.com/switch-infrastructure/config-manager/llms-full.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/switch-infrastructure/config-manager/_mcp/server. # Execute BatchDeployWorkflow POST https://host.com/v1/workflow/ngc/batch_deploy Content-Type: application/json Deploy configurations to a batch of devices with shared diff content Reference: https://docs.nvidia.com/switch-infrastructure/config-manager/switch-infrastructure/config-manager/services/temporal/temporal-api/workflow/batchdeployworkflow-endpoint-v-1-workflow-ngc-batch-deploy-post ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: temporal-api version: 1.0.0 paths: /v1/workflow/ngc/batch_deploy: post: operationId: batchdeployworkflow-endpoint-v-1-workflow-ngc-batch-deploy-post summary: Execute BatchDeployWorkflow description: Deploy configurations to a batch of devices with shared diff content tags: - subpackage_workflow responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/WorkflowResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchDeployInput' servers: - url: https://host.com components: schemas: Platform: type: string enum: - arista-eos - cumulus-linux - nv-os - mlnx-os - ufm description: Network device platform types. title: Platform NetworkDeviceData: type: object properties: backup_enabled: type: boolean default: false config_context: type: - object - 'null' additionalProperties: description: Any type deploy_enabled: type: boolean default: false device_type: type: string id: type: string name: type: string platform: $ref: '#/components/schemas/Platform' position: type: - integer - 'null' primary_ip4: type: - string - 'null' primary_ip6: type: - string - 'null' rack: type: - string - 'null' render_enabled: type: boolean default: false role: type: string site: type: string ztp_enabled: type: boolean default: false required: - device_type - id - name - platform - primary_ip4 - primary_ip6 - role - site description: Network device data. title: NetworkDeviceData DeviceDiffData: type: object properties: commit_id: type: - string - 'null' device: $ref: '#/components/schemas/NetworkDeviceData' diff: type: - string - 'null' error: type: - string - 'null' intended_config: type: - string - 'null' required: - device description: Data structure for device diff information. title: DeviceDiffData DiffGroup: type: object properties: devices: type: array items: $ref: '#/components/schemas/DeviceDiffData' diff_content: type: string diff_hash: type: string required: - devices - diff_content - diff_hash description: |- A group of devices with identical diffs. Note: Each device has its own intended config file and commit SHA. Grouping is only based on identical diff content, not commit IDs. title: DiffGroup BatchDeployInput: type: object properties: batch_devices: type: array items: $ref: '#/components/schemas/DeviceDiffData' batch_number: type: - integer - 'null' commit_confirm: type: boolean default: true diff_group: $ref: '#/components/schemas/DiffGroup' parent_workflow_id: type: string required: - batch_devices - diff_group - parent_workflow_id description: Input for batch deploy child workflow. title: BatchDeployInput WorkflowResponse: type: object properties: href: type: string description: Calculate URL to Temporal UI Workflow View. id: type: string required: - href - id description: Workflow Response Model. title: WorkflowResponse ValidationErrorCtx: type: object properties: {} title: ValidationErrorCtx ValidationErrorLocItems: oneOf: - type: string - type: integer title: ValidationErrorLocItems ValidationError: type: object properties: ctx: $ref: '#/components/schemas/ValidationErrorCtx' input: description: Any type loc: type: array items: $ref: '#/components/schemas/ValidationErrorLocItems' msg: type: string type: type: string required: - loc - msg - type title: ValidationError HTTPValidationError: type: object properties: detail: type: array items: $ref: '#/components/schemas/ValidationError' title: HTTPValidationError ``` ## SDK Code Examples ```python import requests url = "https://host.com/v1/workflow/ngc/batch_deploy" payload = { "batch_devices": [{ "device": { "device_type": "router", "id": "device-1234", "name": "core-router-01", "platform": "arista-eos", "primary_ip4": "192.168.1.10", "primary_ip6": "2001:0db8:85a3::8a2e:0370:7334", "role": "core", "site": "datacenter-1" } }], "diff_group": { "devices": [{ "device": { "device_type": "router", "id": "device-1234", "name": "core-router-01", "platform": "arista-eos", "primary_ip4": "192.168.1.10", "primary_ip6": "2001:0db8:85a3::8a2e:0370:7334", "role": "core", "site": "datacenter-1" } }], "diff_content": "interface Ethernet1 description Uplink to ISP ip address 192.168.1.10/24 !", "diff_hash": "a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4" }, "parent_workflow_id": "workflow-5678" } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://host.com/v1/workflow/ngc/batch_deploy'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"batch_devices":[{"device":{"device_type":"router","id":"device-1234","name":"core-router-01","platform":"arista-eos","primary_ip4":"192.168.1.10","primary_ip6":"2001:0db8:85a3::8a2e:0370:7334","role":"core","site":"datacenter-1"}}],"diff_group":{"devices":[{"device":{"device_type":"router","id":"device-1234","name":"core-router-01","platform":"arista-eos","primary_ip4":"192.168.1.10","primary_ip6":"2001:0db8:85a3::8a2e:0370:7334","role":"core","site":"datacenter-1"}}],"diff_content":"interface Ethernet1\n description Uplink to ISP\n ip address 192.168.1.10/24\n!","diff_hash":"a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4"},"parent_workflow_id":"workflow-5678"}' }; 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://host.com/v1/workflow/ngc/batch_deploy" payload := strings.NewReader("{\n \"batch_devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_group\": {\n \"devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_content\": \"interface Ethernet1\\n description Uplink to ISP\\n ip address 192.168.1.10/24\\n!\",\n \"diff_hash\": \"a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4\"\n },\n \"parent_workflow_id\": \"workflow-5678\"\n}") req, _ := http.NewRequest("POST", url, payload) 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://host.com/v1/workflow/ngc/batch_deploy") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"batch_devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_group\": {\n \"devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_content\": \"interface Ethernet1\\n description Uplink to ISP\\n ip address 192.168.1.10/24\\n!\",\n \"diff_hash\": \"a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4\"\n },\n \"parent_workflow_id\": \"workflow-5678\"\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.post("https://host.com/v1/workflow/ngc/batch_deploy") .header("Content-Type", "application/json") .body("{\n \"batch_devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_group\": {\n \"devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_content\": \"interface Ethernet1\\n description Uplink to ISP\\n ip address 192.168.1.10/24\\n!\",\n \"diff_hash\": \"a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4\"\n },\n \"parent_workflow_id\": \"workflow-5678\"\n}") .asString(); ``` ```php request('POST', 'https://host.com/v1/workflow/ngc/batch_deploy', [ 'body' => '{ "batch_devices": [ { "device": { "device_type": "router", "id": "device-1234", "name": "core-router-01", "platform": "arista-eos", "primary_ip4": "192.168.1.10", "primary_ip6": "2001:0db8:85a3::8a2e:0370:7334", "role": "core", "site": "datacenter-1" } } ], "diff_group": { "devices": [ { "device": { "device_type": "router", "id": "device-1234", "name": "core-router-01", "platform": "arista-eos", "primary_ip4": "192.168.1.10", "primary_ip6": "2001:0db8:85a3::8a2e:0370:7334", "role": "core", "site": "datacenter-1" } } ], "diff_content": "interface Ethernet1\\n description Uplink to ISP\\n ip address 192.168.1.10/24\\n!", "diff_hash": "a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4" }, "parent_workflow_id": "workflow-5678" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://host.com/v1/workflow/ngc/batch_deploy"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"batch_devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_group\": {\n \"devices\": [\n {\n \"device\": {\n \"device_type\": \"router\",\n \"id\": \"device-1234\",\n \"name\": \"core-router-01\",\n \"platform\": \"arista-eos\",\n \"primary_ip4\": \"192.168.1.10\",\n \"primary_ip6\": \"2001:0db8:85a3::8a2e:0370:7334\",\n \"role\": \"core\",\n \"site\": \"datacenter-1\"\n }\n }\n ],\n \"diff_content\": \"interface Ethernet1\\n description Uplink to ISP\\n ip address 192.168.1.10/24\\n!\",\n \"diff_hash\": \"a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4\"\n },\n \"parent_workflow_id\": \"workflow-5678\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = [ "batch_devices": [["device": [ "device_type": "router", "id": "device-1234", "name": "core-router-01", "platform": "arista-eos", "primary_ip4": "192.168.1.10", "primary_ip6": "2001:0db8:85a3::8a2e:0370:7334", "role": "core", "site": "datacenter-1" ]]], "diff_group": [ "devices": [["device": [ "device_type": "router", "id": "device-1234", "name": "core-router-01", "platform": "arista-eos", "primary_ip4": "192.168.1.10", "primary_ip6": "2001:0db8:85a3::8a2e:0370:7334", "role": "core", "site": "datacenter-1" ]]], "diff_content": "interface Ethernet1 description Uplink to ISP ip address 192.168.1.10/24 !", "diff_hash": "a3f5c8d9e7b4f1a2c6d8e9f0b1a2c3d4" ], "parent_workflow_id": "workflow-5678" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://host.com/v1/workflow/ngc/batch_deploy")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" 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() ```