Policies

Create a new policy

Changed on

Creates a new policy. The author_id and last_updated_by are set from the JWT token automatically.

post/policies

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/policies
  • Auth
    HTTP bearer

Request body

titlestring required

Policy title

content_htmlstring required

Full policy content as HTML

statusstring required

Initial policy status

tagsstring[]

Categorization tags (must be from the allowed tag list)

next_review_datestring date-time nullable

Scheduled next review date

assigned_reviewer_idsinteger[]

User IDs to assign as reviewers

is_demoboolean

Mark as a demo policy

Example request

{
  "title": "Data Governance Policy",
  "content_html": "<h1>Data Governance</h1><p>This policy outlines...</p>",
  "status": "draft",
  "tags": [
    "Data governance",
    "Privacy"
  ],
  "next_review_date": "2026-07-01T00:00:00.000Z",
  "assigned_reviewer_ids": [
    2,
    5
  ]
}

Response

Policy created successfully

messagestring

Example response

{
  "message": "Created",
  "data": {
    "id": 42,
    "organization_id": 1,
    "title": "AI Ethics Policy",
    "content_html": "<h1>AI Ethics Policy</h1><p>...</p>",
    "status": "draft",
    "author_id": 1,
    "last_updated_by": 1,
    "assigned_reviewer_ids": [
      2,
      5
    ]
  }
}

Changes