<@U04UQ68083H> Show the docs for /relation-tuples/...
# ory-copilot
c
@chilly-king-10285 Show the docs for /relation-tuples/batch/check
b
A message from kapa.ai
Certainly! Here is the documentation for the
/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
Copy code
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:
Copy code
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).