---
title: "Changes to read schema"
method: POST
path: "/v1/tenants/{tenant_id}/schemas/read"
---

# Changes to read schema

`POST /v1/tenants/{tenant_id}/schemas/read`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 35 revisions.

- **2025-12-28** `f37e45046dd2` — 1 breaking, 1 warning, 18 info
- **2024-08-26** `b7278a55155e` — 15 info
- **2024-08-26** `89d2d169f9dd` — 15 warning
- **2024-08-23** `f3b10e35081b` — 1 breaking, 2 info
- **2024-08-22** `282fb7ba2640` — 3 breaking
- **2024-07-28** `38f9ef0b3d92` — 31 warning
- **2024-07-28** `308fb2406b7e` — 1 breaking, 1 info
- **2024-07-26** `fc4de45efc0a` — 1 info
- **2024-07-24** `d9d0ce949baa` — 1 breaking
- **2024-03-19** `0bc305aa169f` — 2 breaking, 1 warning

## Changes

- **2025-12-28** `f37e45046dd2` — 1 breaking, 1 warning, 18 info
  - the `details/items/additionalProperties/` response's property type changed from `object` to no type for status `default`
  - removed the optional property `schema/entityDefinitions/additionalProperties/permissions/additionalProperties/child/leaf/call/arguments/items/contextAttribute` from the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/callExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/comprehensionExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/constExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/id` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/identExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/listExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/selectExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/structExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/extensions` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/callExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/comprehensionExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/constExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/id` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/identExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/listExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/selectExpr` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/structExpr` to the response with the `200` status
  - the `schema/ruleDefinitions/additionalProperties/expression/referenceMap/additionalProperties/value/bytesValue` response's property pattern `^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$` was removed for the status `200`
- **2024-08-26** `b7278a55155e` — 15 info
  - added the optional property `schema/entityDefinitions/additionalProperties/permissions/additionalProperties/child/leaf` to the response with the `200` status
  - added the optional property `schema/entityDefinitions/additionalProperties/permissions/additionalProperties/child/rewrite` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/abstractType` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/dyn` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/error` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/function` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/listType` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/mapType` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/messageType` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/null` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/primitive` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/type` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/typeParam` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/wellKnown` to the response with the `200` status
  - added the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/wrapper` to the response with the `200` status
- **2024-08-26** `89d2d169f9dd` — 15 warning
  - removed the optional property `schema/entityDefinitions/additionalProperties/permissions/additionalProperties/child/leaf` from the response with the `200` status
  - removed the optional property `schema/entityDefinitions/additionalProperties/permissions/additionalProperties/child/rewrite` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/abstractType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/dyn` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/error` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/function` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/listType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/mapType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/messageType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/null` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/primitive` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/type` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/typeParam` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/wellKnown` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/wrapper` from the response with the `200` status
- **2024-08-23** `f3b10e35081b` — 1 breaking, 2 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `default`
- **2024-08-22** `282fb7ba2640` — 3 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `default`
- **2024-07-28** `38f9ef0b3d92` — 31 warning
  - removed the optional property `schema/entityDefinitions/additionalProperties/permissions/additionalProperties/child/leaf` from the response with the `200` status
  - removed the optional property `schema/entityDefinitions/additionalProperties/permissions/additionalProperties/child/rewrite` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/callExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/comprehensionExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/constExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/id` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/identExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/listExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/selectExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/expr/structExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/callExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/comprehensionExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/constExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/id` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/identExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/listExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/selectExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/sourceInfo/macroCalls/additionalProperties/structExpr` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/abstractType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/dyn` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/error` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/function` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/listType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/mapType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/messageType` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/null` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/primitive` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/type` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/typeParam` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/wellKnown` from the response with the `200` status
  - removed the optional property `schema/ruleDefinitions/additionalProperties/expression/typeMap/additionalProperties/wrapper` from the response with the `200` status
- **2024-07-28** `308fb2406b7e` — 1 breaking, 1 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `schema` to the response with the `200` status
- **2024-07-26** `fc4de45efc0a` — 1 info
  - endpoint added
- **2024-07-24** `d9d0ce949baa` — 1 breaking
  - api path removed without deprecation
- **2024-03-19** `0bc305aa169f` — 2 breaking, 1 warning
  - the response's body type changed from `object` to no type for status `200`
  - the `details/items/additionalProperties/` response's property type changed from no type to `object` for status `default`
  - removed the optional property `schema` from the response with the `200` status

---

[Operation](https://skmtc.dev/permify/apis/permify-api/docs/v1/tenants/:tenant_id/schemas/read/post.md) · [API](https://skmtc.dev/permify/apis/permify-api.md) · [Page](https://skmtc.dev/permify/apis/permify-api/changes/v1/tenants/:tenant_id/schemas/read/post)
