Update ACL

Request

Create an access control list entry with at least one IP address or IP range.

Security

Basic or OAuth2.0

Path

projectIdstringrequired

The projectId is a required parameter you must include when making any API calls. You can find your project ID on your Build dashboard.

Example:3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47

idstringrequired

The ID of the access control list entry.

Bodyapplication/json

namestringrequired

Your name for the access control list entry.

Example:"LA Office"

enabledboolean

Whether the access control list entry is enabled. You can use this to disable a list temporarily without deleting it.

Default:true

ipRangesArray of objects(IpRange)

An array of all the IP ranges to update.

Update an access control list.

curl -i -X PUT \
  -u '<username>:<password>' \
  'https://elastic-trunking.api.sinch.com/v1/projects/3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47/accessControlLists/{id}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Test Prague 5",
    "enabled": false,
    "ipRanges": [
      {
        "description": "Location 1",
        "ipAddress": "15.15.15.16",
        "range": 20
      }
    ]
  }'

Responses

The list of access control list entries

Bodyapplication/json

namestringrequired

Your name for the access control list entry.

Example:"LA Office"

ipRangesArray of objects, non-empty(IpRange)required

The associated IP ranges. When creating you need to submit at least one IP range.

idstringread-only

The ID of the access control list entry.

enabledboolean

Whether the access control list entry is enabled. You can use this to disable an list temporarily without deleting it.

Default:true

trunksArray of stringsread-only

The associated SIP trunks ID.

createTimestring, (date-time)read-only

The time the call was created.

Example:"2021-11-01T23:20:50Z"

updateTimestring, (date-time)read-only

The time the call was created.

Example:"2021-11-01T23:20:50Z"

projectIdstringread-only

The ID of the project.

Response

The updated access control list.

{
  "name": "Test Prague 5",
  "projectId": "3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47",
  "enabled": false,
  "id": "01HA9BRJW4J3QE4WBKVC337V4E",
  "createTime": "2023-09-14T08:08:48",
  "updateTime": "2023-09-14T08:10:10.187513334",
  "ipRanges": [
    { … }
  ]
}

We'd love to hear from you!