Delete relation
- One of the main OpenStreetMap API usabilities
Deletes an existing relation element.
To delete existing relation you must operate inside an open changeset.
Insert the ongoing changeset ID changeset to the request body. After completing various operations on the element, you should close a changset (or it will close automatically). You can also do multiple operations on many elements (create, update, delete) in one ongoing changeset.
In request body the relation ID id and relation version version are also required (check the example).
Request
| Example body request for delete relation with ID | |
|---|---|
Response
| succesDeleteRelation_example.xml | |
|---|---|
Error codes
When there are errors parsing the XML (a text message explaining the error is returned). When a changeset ID is missing, when a node is outside the world. When the version of the provided element does not match the current database version of the element.
When no element with the given ID could be found (example: Requested resource could not be found).
If the changeset in question has already been closed either by the user, or as a result of the auto-closing feature (example: The changeset 412384 was closed at 2025-04-23 11:51:26 UTC). Also, if the user trying to update the changeset is not the same as the one that created it.
If the element has been deleted (example: Requested content is permanently deleted from the server).
When a relation is still member of another relation.
When the request has been blocked due to rate limiting.