POST /v1/tenants/{tenant_id}/data/attributes/readThe Read Attributes endpoint queries stored attribute records and returns those matching the supplied filter. Use it to inspect which attribute values are currently stored for entities in your authorization graph.
Path Parameters The tenant identifier. Use t1 for single-tenant deployments. Must match ^([a-zA-Z0-9_\-@\.:+]{1,128}|\*)$.
Request Body Snap token for consistent reads. Leave empty to read the latest state.
Criteria for selecting which attributes to return. Filter by entity type and/or IDs. Entity type (e.g. document).
List of entity IDs to include.
List of attribute names to filter on (e.g. ["is_private", "region"]).
Number of attributes to return per page. Must be >= 1.
Pagination token from a previous response. Omit for the first page.
Response The list of matching attribute records. The entity the attribute belongs to (type and id).
The attribute value as a typed protobuf Any object.
Pagination token for the next page. Empty when there are no more results.
Example curl --location --request POST 'localhost:3476/v1/tenants/{tenant_id}/data/attributes/read' \ --header 'Content-Type: application/json' \ --data-raw '{ "metadata": { "snap_token": "" }, "filter": { "entity": { "type": "document", "ids": ["1"] }, "attributes": ["is_private"] } }'
Request body { "metadata" : { "snap_token" : "" }, "filter" : { "entity" : { "type" : "document" , "ids" : [ "1" ] }, "attributes" : [ "is_private" ] } }
Response { "attributes" : [ { "entity" : { "type" : "document" , "id" : "1" }, "attribute" : "is_private" , "value" : { "@type" : "type.googleapis.com/base.v1.BooleanValue" , "data" : true } } ], "continuous_token" : "" }
Error Codes HTTP Status Description 400Bad request — invalid filter fields 401Unauthorized 404Tenant not found 429Rate limit exceeded 500Internal server error
