Schema Rules
Validation rules and constraints applied to schema fields.
Returns a paginated list of schema rules owned by the current user. Optionally filter by policy ID.
The number of pages to skip before starting to collect the result set
0The numbers of items to return
20Policy Instance Topic Id
0.0.6046379Successful operation. Returns schema rules array and total count in X-Total-Count header.
Unauthorized request.
Forbidden
Internal server error.
GET /api/v1/schema-rules HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}
]Creates a new schema rule linked to a policy. Schema rules define validation and transformation logic applied to documents within the policy.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Successful operation.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Unauthorized request.
Forbidden
Unprocessable entity.
Internal server error.
POST /api/v1/schema-rules HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 113
{
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"policyId": "69b83f18cd6b7c4adf4139bc"
}{
"createDate": "2026-03-25T15:34:42.540Z",
"updateDate": "2026-03-25T15:34:42.540Z",
"uuid": "f11d9161-a429-46de-989d-3d7bdeb32da6",
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"policyTopicId": "0.0.8251226",
"policyInstanceTopicId": "0.0.8372748",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}Retrieves schema rule for the specified ID.
Schema rule Identifier
69aeb71ef8c5b278e3bab4e5Successful operation.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Unauthorized request.
Forbidden
Unprocessable entity.
Internal server error.
GET /api/v1/schema-rules/{ruleId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"createDate": "2026-03-25T15:34:42.540Z",
"updateDate": "2026-03-25T15:34:42.540Z",
"uuid": "f11d9161-a429-46de-989d-3d7bdeb32da6",
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"policyTopicId": "0.0.8251226",
"policyInstanceTopicId": "0.0.8372748",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}Updates schema rule configuration for the specified rule ID.
Schema Rule Identifier
69aeb71ef8c5b278e3bab4e569aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Successful operation.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Unauthorized request.
Forbidden
Item not found.
Unprocessable entity.
Internal server error.
PUT /api/v1/schema-rules/{ruleId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 97
{
"name": "Updated Rule",
"description": "Updated description",
"policyId": "69aeb71ef8c5b278e3bab4e5"
}{
"createDate": "2026-03-25T15:34:42.540Z",
"updateDate": "2026-03-25T15:34:42.540Z",
"uuid": "f11d9161-a429-46de-989d-3d7bdeb32da6",
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"policyTopicId": "0.0.8251226",
"policyInstanceTopicId": "0.0.8372748",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}Deletes the schema rule with the provided ID.
Schema Rule Identifier
69aeb71ef8c5b278e3bab4e5Successful operation.
Unauthorized request.
Forbidden
Unprocessable entity.
Internal server error.
DELETE /api/v1/schema-rules/{ruleId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
trueActivates schema rule for the specified rule ID.
Schema Rule Identifier
69aeb71ef8c5b278e3bab4e5Successful operation.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Unauthorized request.
Forbidden
Item not found.
Unprocessable entity.
Internal server error.
PUT /api/v1/schema-rules/{ruleId}/activate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"createDate": "2026-03-25T15:34:42.540Z",
"updateDate": "2026-03-25T15:34:42.540Z",
"uuid": "f11d9161-a429-46de-989d-3d7bdeb32da6",
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"policyTopicId": "0.0.8251226",
"policyInstanceTopicId": "0.0.8372748",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}Inactivates schema rule for the specified rule ID.
Schema Rule Identifier
69aeb71ef8c5b278e3bab4e5Successful operation.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Unauthorized request.
Forbidden
Item not found.
Unprocessable entity.
Internal server error.
PUT /api/v1/schema-rules/{ruleId}/inactivate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"createDate": "2026-03-25T15:34:42.540Z",
"updateDate": "2026-03-25T15:34:42.540Z",
"uuid": "f11d9161-a429-46de-989d-3d7bdeb32da6",
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"policyTopicId": "0.0.8251226",
"policyInstanceTopicId": "0.0.8372748",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}Retrieves schema rule relationships for the specified ID.
Schema Rule Identifier
69aeb71ef8c5b278e3bab4e5Successful operation.
Unauthorized request.
Forbidden
Unprocessable entity.
Internal server error.
GET /api/v1/schema-rules/{ruleId}/relationships HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"policy": {
"id": "69aeb71ef8c5b278e3bab4e5",
"uuid": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"name": "Policy name",
"description": "Description",
"topicDescription": "Description",
"policyTag": "Tag",
"status": "DRAFT",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"topicId": "0.0.6046379",
"messageId": "1773670900.819264517",
"codeVersion": "1.0.0",
"createDate": "2026-03-03T17:25:53.312Z",
"version": "1.0.0",
"originalChanged": true,
"config": {},
"userRole": "Installer",
"userRoles": [
"Installer"
],
"userGroup": {
"uuid": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"role": "Installer",
"groupLabel": "Label",
"groupName": "Name",
"active": true
},
"userGroups": [
{
"uuid": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"role": "Installer",
"groupLabel": "Label",
"groupName": "Name",
"active": true
}
],
"policyRoles": [
"Registrant"
],
"policyNavigation": [
{
"role": "Registrant",
"steps": [
{
"block": "Block tag",
"level": 1,
"name": "Step name"
}
]
}
],
"policyTopics": [
{
"name": "Project",
"description": "Project",
"memoObj": "topic",
"static": false,
"type": "any"
}
],
"policyTokens": [
{
"tokenName": "Token name",
"tokenSymbol": "Token symbol",
"tokenType": "non-fungible",
"decimals": "",
"changeSupply": true,
"enableAdmin": true,
"enableFreeze": true,
"enableKYC": true,
"enableWipe": true,
"templateTokenTag": "token_template_0"
}
],
"policyGroups": [
{
"name": "Group name",
"creator": "Registrant",
"groupAccessType": "Private",
"groupRelationshipType": "Multiple",
"members": [
"Registrant"
]
}
],
"categories": [
"string"
],
"projectSchema": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"tests": [
{
"id": "69aeb71ef8c5b278e3bab4e5",
"uuid": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"name": "Test Name",
"policyId": "69aeb71ef8c5b278e3bab4e5",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "NEW",
"date": "2026-03-03T17:25:53.312Z",
"duration": 0,
"progress": 0,
"resultId": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"result": {}
}
],
"ignoreRules": [
{
"code": "string",
"blockType": "string",
"property": "string",
"contains": "string",
"severity": "warning"
}
]
},
"schemas": [
{
"id": "69aeb71ef8c5b278e3bab4e5",
"uuid": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"name": "Schema name",
"description": "Description",
"entity": "POLICY",
"iri": "9db028d2-03ad-4d49-a178-cf4b67f8c147",
"status": "DRAFT",
"topicId": "0.0.6046379",
"version": "1.0.0",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"messageId": "1773670900.819264517",
"category": "POLICY",
"documentURL": "ipfs://AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"contextURL": "ipfs://AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"document": {},
"context": {}
}
]
}Retrieves schema rule data based on the provided options.
69aeb71ef8c5b278e3bab4e569aeb71ef8c5b278e3bab4e569aeb71ef8c5b278e3bab4e569aeb71ef8c5b278e3bab4e5Successful operation.
Unauthorized request.
Forbidden
Unprocessable entity.
Internal server error.
POST /api/v1/schema-rules/data HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 117
{
"policyId": "69aeb71ef8c5b278e3bab4e5",
"schemaId": "69aeb71ef8c5b278e3bab4e5",
"documentId": "69aeb71ef8c5b278e3bab4e5"
}[
{
"rules": {
"id": "69aeb71ef8c5b278e3bab4e5",
"uuid": "69aeb71ef8c5b278e3bab4e5",
"name": "Validation Rule",
"description": "Description",
"creator": "string",
"owner": "string",
"policyId": "69aeb71ef8c5b278e3bab4e5",
"policyTopicId": "69aeb71ef8c5b278e3bab4e5",
"policyInstanceTopicId": "69aeb71ef8c5b278e3bab4e5",
"status": "string",
"config": {}
},
"document": {
"id": "69aeb71ef8c5b278e3bab4e5",
"policyId": "69aeb71ef8c5b278e3bab4e5",
"hash": "hash",
"signature": 0,
"status": "NEW",
"tag": "Block tag",
"type": "Document type",
"createDate": "string",
"updateDate": "string",
"owner": "string",
"document": {
"id": "69aeb71ef8c5b278e3bab4e5",
"type": [
"string"
],
"credentialSubject": {},
"issuer": {},
"issuanceDate": "string",
"proof": {
"type": "string",
"created": "string",
"verificationMethod": "string",
"proofPurpose": "string",
"jws": "string"
}
}
},
"relationships": [
{
"id": "69aeb71ef8c5b278e3bab4e5",
"policyId": "69aeb71ef8c5b278e3bab4e5",
"hash": "hash",
"signature": 0,
"status": "NEW",
"tag": "Block tag",
"type": "Document type",
"createDate": "string",
"updateDate": "string",
"owner": "string",
"document": {
"id": "69aeb71ef8c5b278e3bab4e5",
"type": [
{}
],
"credentialSubject": {},
"issuer": {},
"issuanceDate": "string",
"proof": {
"type": {},
"created": {},
"verificationMethod": {},
"proofPurpose": {},
"jws": {}
}
}
}
]
}
]Imports new rules from the provided zip file into the local DB.
Policy Id
69aeb71ef8c5b278e3bab4e5Successful operation.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Unauthorized request.
Forbidden
Internal server error.
POST /api/v1/schema-rules/{policyId}/import/file HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6
"text"{
"createDate": "2026-03-25T15:34:42.540Z",
"updateDate": "2026-03-25T15:34:42.540Z",
"uuid": "f11d9161-a429-46de-989d-3d7bdeb32da6",
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"policyTopicId": "0.0.8251226",
"policyInstanceTopicId": "0.0.8372748",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}Returns a zip file containing rules.
Schema Rule Identifier
69aeb71ef8c5b278e3bab4e5Successful operation. Response zip file.
Unauthorized request.
Forbidden
Internal server error.
GET /api/v1/schema-rules/{ruleId}/export/file HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"result": "ok"
}Imports a zip file containing rules.
Schema rule preview.
69aeb71ef8c5b278e3bab4e59db028d2-03ad-4d49-a178-cf4b67f8c147Tool nameDescriptiondid:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.820059969aeb71ef8c5b278e3bab4e50.0.60463790.0.6046379DRAFTPossible values: Unauthorized request.
Forbidden
Internal server error.
POST /api/v1/schema-rules/import/file/preview HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6
"text"{
"createDate": "2026-03-25T15:34:42.540Z",
"updateDate": "2026-03-25T15:34:42.540Z",
"uuid": "f11d9161-a429-46de-989d-3d7bdeb32da6",
"name": "Test Schema Rule",
"description": "Description of test schema rule",
"owner": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"creator": "did:hedera:testnet:Cvzp5kKVUuipBCQjcF54fBjdicvaKsB8zHeQ6Qq22U2Z_0.0.8200599",
"status": "DRAFT",
"policyId": "69b83f18cd6b7c4adf4139bc",
"policyTopicId": "0.0.8251226",
"policyInstanceTopicId": "0.0.8372748",
"config": {
"fields": []
},
"id": "69c40092810b639b34bae8a2"
}Last updated