---
title: "Update a tenant management relationship"
method: PATCH
path: "/api/tenant-managements/{aggregate_id}"
tags: ["Tenant Management"]
---

# Update a tenant management relationship

`PATCH /api/tenant-managements/{aggregate_id}`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/tenant-managements/{aggregate_id}`
- Auth: none declared

## Path parameters

- `aggregate_id` string, uuid, required

## Request body

- UpdateTenantManagementRelationshipRequest
  - `role_id` union
    - string, uuid
    - 'UNSPECIFIED'
  - `usage_paid_by` union
    - 'MANAGER' | 'CLIENT': Who pays for a given concern on a managed tenant relationship.
    - 'UNSPECIFIED'
  - `storage_paid_by` union
    - 'MANAGER' | 'CLIENT': Who pays for a given concern on a managed tenant relationship.
    - 'UNSPECIFIED'
  - `user_grants` union
    - UserGrantInput[]
      - `user_id` string, uuid, required
      - `role_id` string, uuid, required
    - 'UNSPECIFIED'

## Response `200`

Successful Response

- TenantManagementRelationshipDTO
  - `aggregate_id` string, uuid, required
  - `manager_tenant_id` string, uuid, required
  - `client_tenant_id` string, uuid, required
  - `manager_tenant` TenantSummaryDTO, required
    - `aggregate_id` string, uuid, required
    - `name` string, required
    - `vat_id` string, nullable, required
  - `client_tenant` TenantSummaryDTO, required
    - `aggregate_id` string, uuid, required
    - `name` string, required
    - `vat_id` string, nullable, required
  - `usage_paid_by` 'MANAGER' | 'CLIENT', required: Who pays for a given concern on a managed tenant relationship.
  - `storage_paid_by` 'MANAGER' | 'CLIENT', required: Who pays for a given concern on a managed tenant relationship.
  - `role` RoleDTO, required
    - `aggregate_id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `permissions` string[], required
    - `is_system_default` boolean, required
    - `is_owner_role` boolean, required
    - `assignment_count` integer
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `user_grants` UserGrantForClientTenantDto[]
    - `user_id` string, uuid, required
    - `email` string, required
    - `name` string, required
    - `role_id` string, uuid, nullable, required
    - `role_name` string, nullable, required
    - `is_owner` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/typless/apis/typless-api.md) · [All operations](https://skmtc.dev/typless/apis/typless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typless/apis/typless-api/revisions/d614787a47ef?raw)