careful-honey-27437
07/20/2025, 4:45 AMbrief-egg-61061
07/20/2025, 4:45 AMbrief-egg-61061
07/20/2025, 4:45 AM/relation-tuples/batch/check
endpoint: --- ### POST /relation-tuples/batch/check
Batch check permissions This endpoint allows you to check multiple permissions in a single request. To learn how relationship tuples and the check works, see the [Ory Keto API overview](https://www.ory.sh/docs/keto/concepts/api-overview). #### Query Parameters | Name | In | Type | Required | Description | Schema | |------------|-------|---------|----------|-------------|-------------------------------| | max-depth | query | integer | False | | {'format': 'int64', 'type': 'integer'} | #### Request Body json { "tuples": [ { "namespace": "string", "object": "string", "relation": "string", "subject_id": "string", // Either subject_id or subject_set can be provided "subject_set": { "namespace": "string", "object": "string", "relation": "string" } } // ... more tuples ] }
- `tuples`: An array of relationship objects to check. Each object must include namespace
, object
, and relation
. You can specify either subject_id
or a subject_set
. #### Responses - 200 OK Returns a result for each tuple in the same order as the input: json { "results": [ { "allowed": true, "error": "string" // Optional, any error generated while checking } // ... more results ] }
- 400 Bad Request Returns a standard Ory JSON API error format if the request is invalid. - default Returns a standard Ory JSON API error format for other errors. For more details, see the [Ory API Reference](https://raw.githubusercontent.com/ory/docs/master/docs/reference/api.json) and [Keto API Reference](https://raw.githubusercontent.com/ory/keto/master/spec/api.json).