---
title: "Add a new permission to a dialpolicy table"
method: POST
path: "/dialpolicy/{policy}/permission"
tags: ["Dial Permisions"]
---

# Add a new permission to a dialpolicy table

`POST /dialpolicy/{policy}/permission`

## Request

- Base URL: `https://ns-api.com/ns-api/v2`
- URL: `https://ns-api.com/ns-api/v2/dialpolicy/{policy}/permission`
- Auth: HTTP bearer

## Path parameters

- `policy` string, required

## Request body

- object
  - `synchronous` 'yes' | 'no', required: When synchronous is requested with "yes" the response will be a 200 on success and will contain a valid JSON representiation of the new resource. If no or left off request a 202 "Accepted" will be given in a success case and this can be considered a success. Synchronous responses will be a little slower as the API will process the geo replication request and wait till the local copy has been written and can be read back berfore sending a response.
  - `permission-match` string, required: The specific match to check against
  - `permission-mode` 'permit' | 'deny', required: To allow or deny specific match
  - `permission-reason` string, required: The description/reason for making the rule.

## Response `200`

- Permission
  - `dialpolicy` string, required: The Dial Policy Name
  - `domain` string: The domain the owns the Dial Policy
  - `permission-match` string, required: The specific match to check against
  - `permission-mode` 'permit' | 'deny', required: To allow or deny specific match
  - `permission-reason` string, required: The description/reason for making the rule.
  - `created-datetime` string: The time the rule was created
  - `permission-id` string, required: This is the ID fro the permission rule. Its the base64 encode of permission-match, but is needed for edit and delete.

## Other responses

- `202`

## Changes

- **2026-11-03** `bce16087d479`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/changes/dialpolicy/:policy/permission/post.md)

---

[API](https://skmtc.dev/ns-api/apis/netsapiens-api-v2.md) - [All operations](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/revisions/bce16087d479?raw)