---
title: "Update a tenant"
method: PUT
path: "/tenants/update"
tags: ["Tenants"]
---

# Update a tenant

`PUT /tenants/update`

Use when changing tenant details (e.g. name or billing info). Request body contains the fields to update.

## Request body

- UpdateTenantRequest
  - `billing_details` TenantBillingDetails
    - `address` Address
      - `address_city` string
      - `address_country` string
      - `address_line1` string
      - `address_line2` string
      - `address_postal_code` string
      - `address_state` string
    - `email` string
    - `help_email` string
    - `phone` string
  - `metadata` TypesMetadata
  - `name` string

## Response `200`

Updated tenant

- TenantResponse
  - `billing_details` TenantBillingDetails
    - `address` Address
      - `address_city` string
      - `address_country` string
      - `address_line1` string
      - `address_line2` string
      - `address_postal_code` string
      - `address_state` string
    - `email` string
    - `help_email` string
    - `phone` string
  - `created_at` string, date-time
  - `id` string
  - `metadata` TypesMetadata
  - `name` string
  - `status` string
  - `updated_at` string, date-time

## Other responses

- `400` — Invalid request
- `404` — Tenant not found
- `500` — Server error

## Changes

- **2026-07-15** `f8ecf435d25d` — 3 warning
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `404`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
- **2026-07-09** `7d57386313c7` — 2 breaking
  - the `metadata` request property type changed from no type to `object`
  - the `metadata` response's property type changed from no type to `object` for status `200`
- **2026-07-09** `4b1a811c4179` — 4 breaking
  - the `metadata` request property type changed from `object` to no type
  - the `created_at` response's property format changed from `date-time` to no format for status `200`
  - the `metadata` response's property type changed from `object` to no type for status `200`
  - the `updated_at` response's property format changed from `date-time` to no format for status `200`
- **2026-05-18** `8ec2edea6b20` — 6 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `404` status
  - removed the optional property `details` from the response with the `500` status
  - added the new `too_many_requests` enum value to the `code` response property for the response status `400`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/flexprice/apis/flexprice-api/changes/tenants/update/put.md)

---

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