---
title: "Delete Relation Tuples"
method: DELETE
path: "/relation-tuples"
tags: ["write"]
---

# Delete Relation Tuples

`DELETE /relation-tuples`

Use this endpoint to delete relation tuples

## Query parameters

- `namespace` string
- `object` string
- `relation` string
- `subject_id` string
- `subject_set.namespace` string
- `subject_set.object` string
- `subject_set.relation` string

## Response `204`

Empty responses are sent when, for example, resources are deleted. The HTTP status code for empty responses is typically 201.

## Other responses

- `400` — genericError
- `500` — genericError

## Changes

- **2022-02-09** `a88adf308b2b` — 2 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `500`
- **2022-01-21** `483bc0512f55` — 7 info
  - added the new optional `query` request parameter `namespace`
  - added the new optional `query` request parameter `object`
  - added the new optional `query` request parameter `relation`
  - added the new optional `query` request parameter `subject_id`
  - …3 more
- **2022-01-21** `975bed767f2a` — 7 warning, 1 info
  - deleted the `query` request parameter `namespace`
  - deleted the `query` request parameter `object`
  - deleted the `query` request parameter `relation`
  - deleted the `query` request parameter `subject_id`
  - …4 more
- **2022-01-21** `110a4dab6e84` — 3 info
  - the `query` request parameter `namespace` became optional
  - the `query` request parameter `object` became optional
  - the `query` request parameter `relation` became optional
- **2021-10-07** `e90046dbd055` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ory/apis/ory-keto-api/changes/relation-tuples/delete.md)

---

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