v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014121451.1 MB

Policies

Get compliance policy

Retrieve a single compliance policy by its ID, including current content, draft content, review status, framework links, and audit metadata. Use this to read or inspect one policy in detail. If you only have a policy name, find its ID first by listing compliance policies.

get/v1/policies/{id}

Path parameters

idstring required

Example:pol_abc123def456

Policy ID

Headers

X-Organization-Idstring

Organization ID (required for session auth, optional for API key auth)

Response

Policy retrieved successfully

idstring required

The policy ID

namestring required

Name of the policy

descriptionstring nullable required

Description of the policy

status'draft' | 'published' | 'needs_review' required

Status of the policy

contentobject[] required

Content of the policy as TipTap JSON (array of nodes)

frequency'monthly' | 'quarterly' | 'yearly' nullable required

Review frequency of the policy

departmentstring nullable required

Department this policy applies to. May be one of the built-in values (none, admin, gov, hr, it, itsm, qms) or a custom department name.

isRequiredToSignboolean required

Whether this policy requires a signature

signedBystring[] required

List of user IDs who have signed this policy

reviewDatestring date-time nullable required

Review date for the policy

isArchivedboolean required

Whether this policy is archived

archivedAtstring date-time nullable required

When the policy was archived by framework sync

createdAtstring date-time required

When the policy was created

updatedAtstring date-time required

When the policy was last updated

lastArchivedAtstring date-time nullable required

When the policy was last archived

lastPublishedAtstring date-time nullable required

When the policy was last published

organizationIdstring required

Organization ID this policy belongs to

assigneeIdstring nullable required

ID of the user assigned to this policy

approverIdstring nullable required

ID of the user who approved this policy

policyTemplateIdstring nullable required

ID of the policy template this policy is based on

Example response

{
  "id": "pol_abc123def456",
  "name": "Data Privacy Policy",
  "description": "This policy outlines how we handle and protect personal data",
  "status": "draft",
  "content": [
    {
      "type": "heading",
      "attrs": {
        "level": 2,
        "textAlign": null
      },
      "content": [
        {
          "type": "text",
          "text": "Purpose"
        }
      ]
    },
    {
      "type": "paragraph",
      "attrs": {
        "textAlign": null
      },
      "content": [
        {
          "type": "text",
          "text": "Verify workforce integrity and grant the right access at start, revoke at end."
        }
      ]
    }
  ],
  "frequency": "yearly",
  "department": "it",
  "isRequiredToSign": true,
  "signedBy": [
    "usr_123",
    "usr_456"
  ],
  "reviewDate": "2024-12-31T00:00:00.000Z",
  "archivedAt": "2024-02-01T00:00:00.000Z",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-15T00:00:00.000Z",
  "lastArchivedAt": "2024-02-01T00:00:00.000Z",
  "lastPublishedAt": "2024-01-10T00:00:00.000Z",
  "organizationId": "org_abc123def456",
  "assigneeId": "usr_abc123def456",
  "approverId": "usr_xyz789abc123",
  "policyTemplateId": "plt_template123"
}