Creating a Policy using APIs

Endpoints for creating, configuring, publishing, importing, and interacting with Guardian policies. These APIs cover the full policy lifecycle including block data retrieval and group management.

Authentication: Bearer token required (Authorization: Bearer <token>)

Permission: Standard Registry role required for write operations.

---

Method	Endpoint	Description	Auth Required
GET	/api/v1/policies	Returns all policies for the current user	Yes
POST	/api/v1/policies	Creates a new policy	Yes
GET	/api/v1/policies/{policyId}	Returns a policy configuration	Yes
PUT	/api/v1/policies/{policyId}	Updates a policy configuration	Yes
PUT	/api/v1/policies/{policyId}/publish	Publishes a policy to Hedera	Yes
POST	/api/v1/policies/{policyId}/validate	Validates a policy configuration	Yes
GET	/api/v1/policies/{policyId}/export/file	Exports a policy as a ZIP file	Yes
GET	/api/v1/policies/{policyId}/export/message	Returns the policy Hedera message ID	Yes
POST	/api/v1/policies/import/file	Imports a policy from a ZIP file	Yes
POST	/api/v1/policies/import/message	Imports a policy from an IPFS message ID	Yes
POST	/api/v1/policies/import/file-metadata	Imports a policy from a ZIP file with metadata	Yes
POST	/api/v1/policies/import/message/preview	Previews a policy from an IPFS message ID	Yes
GET	/api/v1/policies/{policyId}/blocks	Returns the root block data for a running policy	Yes
GET	/api/v1/policies/{policyId}/blocks/{blockId}	Returns data for the specified block	Yes
POST	/api/v1/policies/{policyId}/blocks/{blockId}	Sends data to the specified block	Yes
GET	/api/v1/policies/{policyId}/tag/{tagName}	Returns a block ID by its tag name	Yes
GET	/api/v1/policies/{policyId}/tag/{tagName}/blocks	Returns block data by tag	Yes
POST	/api/v1/policies/{policyId}/tag/{tagName}/blocks	Sends data to the block identified by tag	Yes
GET	/api/v1/policies/{policyId}/groups	Returns user groups for the policy	Yes
POST	/api/v1/policies/{policyId}/groups	Makes the selected group active	Yes
GET	/api/v1/policies/{policyId}/multiple	Returns the multi-policy configuration	Yes
POST	/api/v1/policies/multiple	Creates a link between policies	Yes

Endpoints

• Prerequisite Steps

• Policy Listing

• Creation of a Policy

• Retrieves Policy Configuration

• Updates Policy Configuration

• Publish a Policy

• Policy Validation

• Export to ZIP File

• Exporting Message ID

• Import from ZIP File

• Import a Policy

• Importing Policy from a ZIP File with Metadata

• Policy Preview from IPFS

• Retrieval of Data from Root Policy Block

• Request Block Data

• Sends Data to Specified Block

• Returns Block ID by Tag

• Retrieves Block Data by Tag

• Sends Data to Specified Block by Tag

• Sends Data to Specified Block as per Tag

• Sends Data to Specified Block Synchronously

• Returns List of Groups of a Particular User

• Make the Selected Group Active

• Requesting Multi-Policy Config

• Creating Link Between Policies