---
title: "Batch update connectors"
method: PATCH
path: "/v1/agents/{agentId}/telephony/connectors/batch"
tags: ["Connectors"]
---

# Batch update connectors

`PATCH /v1/agents/{agentId}/telephony/connectors/batch`

## Request body

- BatchUpdateConnectorsBody — Ordered list of connector updates. Each update is applied independently — partial success is possible.
  - `updates` BatchUpdateConnectorItem[], required — List of connector updates
    - `connectorId` string, required — Connector ID to update
    - `variantId` string — Variant ID to assign, or null to unassign
    - `asrLangCode` string — ASR language code
    - `voiceName` string — Google TTS voice name
    - `projectId` string — Move connector to a different project

## Response `200`

Successful response

- BatchUpdateConnectorsResponse — Per-connector results from a batch update. Each entry reports success or failure independently.
  - `results` BatchUpdateResultItem[], required
    - `connectorId` string, required
    - `success` boolean, required
    - `data` ConnectorResponse — A connector: the voice, language, variant, and environment bundle that handles incoming calls. Multiple phone numbers can share one connector.
      - `connectorId` string, required — Unique connector identifier
      - `name` string, required — Connector display name
      - `accountId` string, required — Account this connector belongs to
      - `projectId` string, required — Project this connector belongs to
      - `clientEnv` string, required — Client environment (sandbox, pre-release, live)
      - `variantId` string, required — Assigned variant ID (empty string if unassigned)
      - `asrLangCode` string, required — ASR language code (e.g. en-US)
      - `ttsLangCode` string, required — TTS language code (e.g. en-US)
      - `voiceName` string, required — Google TTS voice name (e.g. en-US-Neural2-A)
      - `disableHandoff` boolean, required — Whether call handoff is disabled
    - `error` string — Error message (present when success=False)

## Other responses

- `400` — Validation error
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – insufficient permissions

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/revisions/76f3c606e395/schema)