---
title: "PUT /relationships/{id}"
method: PUT
path: "/relationships/{id}"
tags: ["relationships"]
---

# PUT /relationships/{id}

`PUT /relationships/{id}`

## Request

- Base URL: `https://api.propstack.de/v2`
- URL: `https://api.propstack.de/v2/relationships/{id}`
- Auth: API key in header `X-Api-Key`

Update relationship metadata; replace a relationship to change its participants

## Path parameters

- `id` integer, required

## Request body

- PutRelationshipsId: Update relationship metadata; replace a relationship to change its participants
  - `name` string
  - `relationship_category_id` integer
  - `transfer_client_data` boolean
  - `subcontact` boolean

## Response `200`

Update relationship metadata; replace a relationship to change its participants

- RelationshipEntity: RelationshipEntity model
  - `id` integer
  - `name` string
  - `internal_name` 'owner' | 'associate' | 'partner'
  - `client_id` integer
  - `property_id` integer
  - `project_id` integer
  - `related_client_id` integer
  - `client_property_id` integer
  - `relationship_category_id` integer
  - `transfer_client_data` boolean
  - `subcontact` boolean

## Other responses

- `400`: validation_error
- `401`: authentication_error
- `403`: authorization_error
- `404`: not_found_error
- `422`: validation_error
- `429`: rate_limit_exceeded
- `500`: internal_server_error

## Changes

- **2026-11-04** `b68ea1933caa`: 1 info
  - added the non-success response with the status `429`
- **2026-10-09** `66a565c0ca01`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/propstack/apis/propstack-api-v2-beta/changes/relationships/:id/put.md)

---

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