---
title: "PUT /sip-rules/{sipRuleId}"
method: PUT
path: "/sip-rules/{sipRuleId}"
---

# PUT /sip-rules/{sipRuleId}

`PUT /sip-rules/{sipRuleId}`

Updates the details of the specified SIP rule.

## Path parameters

- `sipRuleId` string, required

## Request body

- object
  - `Name` string, required — The new name for the specified SIP rule.
  - `Disabled` boolean — The new value specified to indicate whether the rule is disabled.
  - `TargetApplications` SipRuleTargetApplication[] — The new value of the list of target applications.
    - `SipMediaApplicationId` string — The SIP media application ID.
    - `Priority` integer — Priority of the SIP media application in the target list.
    - `AwsRegion` string — The AWS Region of the target application.

## Response `202`

Success

- UpdateSipRuleResponse
  - `SipRule` object — Updated SIP rule details.
    - `SipRuleId` string — The SIP rule ID.
    - `Name` string — The name of the SIP rule.
    - `Disabled` boolean — Indicates whether the SIP rule is enabled or disabled. You must disable a rule before you can delete it.
    - `TriggerType` 'ToPhoneNumber' | 'RequestUriHostname' — The type of trigger assigned to the SIP rule in <code>TriggerValue</code>, currently <code>RequestUriHostname</code> or <code>ToPhoneNumber</code>.
    - `TriggerValue` string — If <code>TriggerType</code> is <code>RequestUriHostname</code>, then the value can be the outbound host name of the Amazon Chime Voice Connector. If <code>TriggerType</code> is <code>ToPhoneNumber</code>, then the value can be a customer-owned phone number in E164 format. <code>SipRule</code> is triggered when a SIP rule requests host name or <code>ToPhoneNumber</code> matches in the incoming SIP request.
    - `TargetApplications` SipRuleTargetApplication[] — Target SIP media application and other details, such as priority and AWS Region, to be specified in the SIP rule. Only one SIP rule per AWS Region can be provided.
      - `SipMediaApplicationId` string — The SIP media application ID.
      - `Priority` integer — Priority of the SIP media application in the target list.
      - `AwsRegion` string — The AWS Region of the target application.
    - `CreatedTimestamp` string, date-time — The time at which the SIP rule was created, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The time at which the SIP rule was last updated, in ISO 8601 format.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ConflictException
- `485` — ThrottledClientException
- `486` — ResourceLimitExceededException
- `487` — ServiceUnavailableException
- `488` — 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/revisions/40da18840201/schema)