Policy Languages

List the organization's configured Policy languages and which one is the default. Returns an empty list when the Policy languages feature is disabled for the organization.

🔒 Requires Policies: List Policies permission.

List Policy Version language variants. Narrow to a single Policy Version with policyVersionId, or to every Version of a Policy with policyId. Scope to the parent Version status with statuses[] — statuses[]=PUBLISHED excludes variants attached to draft Versions. One row per language variant, so a Policy Version with several languages does not multiply rows in other collections. This is the endpoint to use when you need languages across multiple Policy Versions — the policy-version list endpoint does not expand them. Downloads are not available here: use GET /policy-language-versions/{policyLanguageVersionId} with expand[]=downloadUrl or expand[]=downloadPdfUrl. Returns an empty list when the Policy languages feature is disabled for the organization.

🔒 Requires Policies: List Policies permission.

List the language variants of a single Policy Version. The version-scoped view of /policy-language-versions — the rows are the same, addressed through the Policy and Policy Version that own them. Use this when you already hold both identifiers; use /policy-language-versions when you need language rows across several Versions or Policies in one call, or when you want the parent relations expanded. Narrow by the parent Version status with statuses[]. Returns 404 when policyVersionId is not a Version of policyId, rather than an empty list that would be indistinguishable from a Version with no variants. Returns an empty list when the Policy languages feature is disabled for the organization.

🔒 Requires Policies: List Policies permission.

Get a single Policy Version language variant by its identifier, as returned in the id of a /policy-language-versions row. Returns the variant's metadata (default), or its authored HTML content when Accept: text/html is sent.

Downloads: expand[]=downloadUrl returns a short-lived signed URL for the uploaded document in its original format, and expand[]=downloadPdfUrl one for the PDF rendering. Either returns null — not an error — when this language has no content of that kind, matching hasFile / hasPdf on the same response. Requesting either is recorded as a Policy download against the selected language; reading the HTML is not. These two expands are available only here, never on the /policy-language-versions collection.

Returns 404 when the identifier is unknown, when the variant belongs to another organization, when the variant has been deleted, and when the Policy languages feature is disabled for the organization — the collection degrades to an empty list in that case, and an item endpoint has no equivalent empty success to return. The four are deliberately indistinguishable. Accept: text/html also returns 404 when this language has no authored HTML: the body is the entire response, so an empty one could be mistaken for content. Note this is stricter than GET /policies/{policyId}/policy-versions/{policyVersionId}, which answers 200 with an empty body for a Policy Version with no HTML.

Variants attached to draft Policy Versions are readable and downloadable here, consistent with the policy-version endpoint's own download expands. Scope to published content with statuses[]=PUBLISHED on the collection.

🔒 Requires Policies: List Policies permission.