---
title: "Changes to Create or replace a relation by id"
method: PUT
path: "/api/v2/relation/{id}"
---

# Changes to Create or replace a relation by id

`PUT /api/v2/relation/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-10-20** `78df39c4c62e`: 7 warning
- **2026-10-20** `4dd5b1cd0687`: 14 warning, 2 info

## Changes

- **2026-10-20** `78df39c4c62e`: 7 warning
  - added the new `known_of_not_writable` enum value to the `error/code` response property for the response status `400`
  - added the new `known_of_not_writable` enum value to the `error/code` response property for the response status `401`
  - added the new `known_of_not_writable` enum value to the `error/code` response property for the response status `403`
  - added the new `known_of_not_writable` enum value to the `error/code` response property for the response status `409`
  - added the new `known_of_not_writable` enum value to the `error/code` response property for the response status `422`
  - added the new `known_of_not_writable` enum value to the `error/code` response property for the response status `429`
  - added the new `known_of_not_writable` enum value to the `error/code` response property for the response status `503`
- **2026-10-20** `4dd5b1cd0687`: 14 warning, 2 info
  - added the new `character_taken` enum value to the `error/code` response property for the response status `400`
  - added the new `character_taken` enum value to the `error/code` response property for the response status `401`
  - added the new `character_taken` enum value to the `error/code` response property for the response status `403`
  - added the new `character_taken` enum value to the `error/code` response property for the response status `409`
  - added the new `character_taken` enum value to the `error/code` response property for the response status `422`
  - added the new `character_taken` enum value to the `error/code` response property for the response status `429`
  - added the new `character_taken` enum value to the `error/code` response property for the response status `503`
  - added the new `world_full` enum value to the `error/code` response property for the response status `400`
  - added the new `world_full` enum value to the `error/code` response property for the response status `401`
  - added the new `world_full` enum value to the `error/code` response property for the response status `403`
  - added the new `world_full` enum value to the `error/code` response property for the response status `409`
  - added the new `world_full` enum value to the `error/code` response property for the response status `422`
  - added the new `world_full` enum value to the `error/code` response property for the response status `429`
  - added the new `world_full` enum value to the `error/code` response property for the response status `503`
  - added the optional property `known_of` to the response with the `200` status
  - added the optional property `known_of` to the response with the `201` status

---

[Operation](https://skmtc.dev/onlyworlds/apis/onlyworlds-api/docs/api/v2/relation/:id/put.md) · [API](https://skmtc.dev/onlyworlds/apis/onlyworlds-api.md) · [Page](https://skmtc.dev/onlyworlds/apis/onlyworlds-api/changes/api/v2/relation/:id/put)