---
title: "Update Tenant Properties"
method: PATCH
path: "/v1/tenant/{tenant_id}/properties/"
---

# Update Tenant Properties

`PATCH /v1/tenant/{tenant_id}/properties/`

Update a tenant's custom `properties` in one of two ways:

- **Replace entire payload** — send `{ "properties": { ... } }` to replace the entire custom properties object with the payload. Any custom property key not in the payload is removed.
- **Update individual properties** — send `{ "operations": [ ... ] }` with `$set` and `$unset` operators to add, update, or remove individual property keys without touching the rest. Use `$set` to add new keys or overwrite the value of existing keys. Use `$unset` to delete existing keys.

Only custom `properties` are affected by this endpoint. Use the [Create / Update Tenants](/reference/create-update-tenants) endpoint to update reserved fields such as branding, `blocked_channels`, or `parent_id`.

## Path parameters

- `tenant_id` string, required

## Request body

- union
  - object — Replace the entire custom properties object with the payload.
    - `properties` object, required — The new custom properties object. Replaces the tenant's existing custom properties in full.
  - object — Update individual property keys with `$set` / `$unset` operators.
    - `operations` object[], required — Ordered list of operations to apply.
      - `$set` object — Add or update these keys in the tenant's custom properties.
      - `$unset` string[] — Pass property keys to remove.

## Response `200`

Tenant properties updated. Returns the tenant's identifier fields and its updated `properties` object.

- object — The tenant with its updated local custom `properties`.

## Other responses

- `404` — 404 - Not Found

## Changes

- **2026-08-30** `ea7b2f7c41a9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/suprsend/apis/suprsend-api/changes/v1/tenant/:tenant_id/properties/patch.md)

---

[API](https://skmtc.dev/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.dev/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/revisions/ea7b2f7c41a9/schema)