---
title: "Update tenant custom headers"
method: POST
path: "/tenant/custom_headers"
tags: ["Tenant"]
---

# Update tenant custom headers

`POST /tenant/custom_headers`

Update tenant custom headers.

## Request body

- object — The added custom SIP headers and forwarded SIP headers in tenant scope.
  - `add` object[]
    - `name` string — The name of custom SIP header.
    - `value` string — The value of custom SIP header.
    - `scope` 'ALL' | 'TRUNK' | 'USER' — The applied calls of custom SIP headers: Can be either: - `ALL`: Applies to all calls. - `TRUNK`: Applies to trunk calls. - `USER`: Applies to user calls.
  - `relay` object[]
    - `name` string — The name of custom SIP header.
    - `scope` 'ALL' | 'TRUNK' | 'USER' — The applied calls of custom SIP headers: Can be either: - `ALL`: Applies to all calls. - `TRUNK`: Applies to trunk calls. - `USER`: Applies to user calls.

## Response `200`

OK

## Other responses

- `4XX` — Error

---

[API](https://skmtc.net/portsip/apis/portsip-pbx-rest-api.md) · [All operations](https://skmtc.net/portsip/apis/portsip-pbx-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portsip/portsip-pbx-rest-api/revisions/577415d4a3d5/schema)