---
title: "POST /voice-connectors/{voiceConnectorId}/proxy-sessions/{proxySessionId}"
method: POST
path: "/voice-connectors/{voiceConnectorId}/proxy-sessions/{proxySessionId}"
---

# POST /voice-connectors/{voiceConnectorId}/proxy-sessions/{proxySessionId}

`POST /voice-connectors/{voiceConnectorId}/proxy-sessions/{proxySessionId}`

Updates the specified proxy session details, such as voice or SMS capabilities.

## Path parameters

- `voiceConnectorId` string, required
- `proxySessionId` string, required

## Request body

- object
  - `Capabilities` Capability[], required — The proxy session capabilities.
  - `ExpiryMinutes` integer — The number of minutes allowed for the proxy session.

## Response `201`

Success

- UpdateProxySessionResponse
  - `ProxySession` object — The proxy session details.
    - `VoiceConnectorId` string — The Amazon Chime voice connector ID.
    - `ProxySessionId` string — The proxy session ID.
    - `Name` string — The name of the proxy session.
    - `Status` 'Open' | 'InProgress' | 'Closed' — The status of the proxy session.
    - `ExpiryMinutes` integer — The number of minutes allowed for the proxy session.
    - `Capabilities` Capability[] — The proxy session capabilities.
    - `CreatedTimestamp` string, date-time — The created time stamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The updated time stamp, in ISO 8601 format.
    - `EndedTimestamp` string, date-time — The ended time stamp, in ISO 8601 format.
    - `Participants` Participant[] — The proxy session participants.
      - `PhoneNumber` string, password — The participant's phone number.
      - `ProxyPhoneNumber` string, password — The participant's proxy phone number.
    - `NumberSelectionBehavior` 'PreferSticky' | 'AvoidSticky' — The preference for proxy phone number reuse, or stickiness, between the same participants across sessions.
    - `GeoMatchLevel` 'Country' | 'AreaCode' — The preference for matching the country or area code of the proxy phone number with that of the first participant.
    - `GeoMatchParams` object — The country and area code for the proxy phone number.
      - `Country` string, required — The country.
      - `AreaCode` string, required — The area code.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/versions/40da18840201/schema)