> ## Documentation Index > Fetch the complete documentation index at: https://docs.vocobase.com/llms.txt > Use this file to discover all available pages before exploring further. # Rename a telephony connection > Updates the display name of an active partner-owned telephony connection. Credentials are not rotated by this endpoint. ## OpenAPI ````yaml /openapi.json patch /telephony/connections/{connection_id} openapi: 3.1.0 info: title: Vocobase Partner API version: '2.0' description: >- API for managing voice AI agents, documents, and calls on the Vocobase platform. servers: - url: https://api.vocobase.com/api/v2 description: Production security: - bearerAuth: [] tags: - name: Config description: >- Read and update partner configuration, webhook settings, and telephony credentials. - name: Agents description: Create, read, update, and delete voice AI agents. - name: Voices description: >- List voice tiers, available voices, and stream preview audio for agent configuration. - name: Documents description: Upload, manage, and delete knowledge base documents. - name: Agent Documents description: Link and unlink documents to agents for knowledge base integration. - name: Calls description: Initiate outbound calls and view call history. - name: Phone Numbers description: >- Import DIDs, assign agents for inbound routing, and re-sync carrier Application bindings. - name: Inbound Routing Policies description: >- Define pre-answer routing decisions for inbound calls before AI sessions are created. - name: Telephony Connections description: Create, list, rename, and disconnect named V2 telephony connections. - name: VoiceLink Management description: Manage VoiceLink reseller clients, DID mapping, and readiness sync. - name: Projects description: Organize agents into projects. Every agent belongs to exactly one project. - name: Dictionaries description: Speech-recognition dictionary CRUD and agent attachment. - name: Sessions description: Browser-initiated WebRTC voice sessions for in-app voice agents. paths: /telephony/connections/{connection_id}: patch: tags: - Telephony Connections summary: Rename a telephony connection description: >- Updates the display name of an active partner-owned telephony connection. Credentials are not rotated by this endpoint. operationId: renameTelephonyConnection parameters: - name: connection_id in: path required: true schema: type: string format: uuid description: Telephony connection ID. requestBody: required: true content: application/json: schema: type: object required: - name properties: name: type: string minLength: 1 maxLength: 100 example: Plivo India - Support responses: '200': description: Connection renamed. content: application/json: schema: type: object properties: success: type: boolean const: true data: type: object properties: connection: $ref: '#/components/schemas/TelephonyConnection' '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' components: schemas: TelephonyConnection: type: object description: Named V2 telephony connection. Secrets are never returned. properties: id: type: string format: uuid connection_id: type: string format: uuid description: >- Stable connection ID to pass to call-start and phone-number endpoints. provider: type: string enum: - twilio - exotel - plivo - vobiz - tata_smartflo - sip - voicelink - mcube provider_key: type: string enum: - TWILIO - EXOTEL - PLIVO - VOBIZ - TATA_SMARTFLO - SIP - VOICELINK - MCUBE name: type: string status: type: string enum: - ACTIVE - INVALID_CREDENTIALS - DISCONNECTED is_default: type: boolean last_verified_at: type: - string - 'null' format: date-time last_error_message: type: - string - 'null' phone_numbers: type: array items: $ref: '#/components/schemas/PhoneNumber' livekit_sip_uri: type: - string - 'null' description: Returned for SIP create responses when available. created_at: type: string format: date-time updated_at: type: string format: date-time PhoneNumber: type: object description: Imported carrier DID managed through the V2 phone-numbers API. properties: id: type: string format: uuid connection_id: type: string format: uuid description: Telephony connection that owns this DID. connection_name: type: - string - 'null' description: Display name of the owning telephony connection. phone_number: type: string description: >- DID in E.164 format. A connection-detail response may also include the MCube default exeNumber in national format; manually imported MCube DIDs are always E.164. example: '+918065480085' provider: type: string enum: - TWILIO - EXOTEL - PLIVO - VOBIZ - TATA_SMARTFLO - SIP - VOICELINK - MCUBE description: Carrier connection that owns this DID. friendly_name: type: - string - 'null' status: type: string enum: - ACTIVE - INACTIVE is_default: type: boolean description: True when this DID is the connection's default outbound from-number. inbound_enabled: type: boolean description: >- True when this active DID is eligible to receive inbound calls for its assigned agent. Only one active row per DID can have this set to true. agent: type: - object - 'null' properties: id: type: string format: uuid name: type: string description: >- Assigned agent, or null when unassigned. The DID receives inbound calls only when `inbound_enabled` is true. created_at: type: string format: date-time updated_at: type: string format: date-time ErrorResponse: type: object properties: success: type: boolean const: false error: type: object properties: code: type: string message: type: string required: - code - message required: - success - error responses: ValidationError: description: Validation error in request body or parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: VALIDATION_ERROR message: agent_name is required and must be max 50 characters Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: UNAUTHORIZED message: Invalid or missing API key NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: NOT_FOUND message: Resource not found InternalError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: INTERNAL_ERROR message: An unexpected error occurred securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key in format: `rg_live_xxxx`. Pass as a Bearer token in the Authorization header. ````