Docs

Docs

x-cpod-domain: policies

Policies

Org-wide policy documents (acceptable use, data handling). Sits adjacent to GRC.

Try in explorer client.policies

Policy

A versioned policy document with an owner and review cadence.

REST path/api/v1/policies
Operations
listgetcreateupdatecomplete
SDK
// list — returns only your records; add filters/search:
await client.policies.policies.list()

// create:
await client.policies.policies.create({
  id: "rec_01HXEXAMPLE",
  tenant_id: "example tenant_id",
  created_at: "2026-01-01T00:00:00Z",
  updated_at: "2026-01-01T00:00:00Z",
  app_id: "example app_id",
  created_by: "rec_01HXEXAMPLE",
})
FieldTypeDescription
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumWhere the write originated. Defaults to 'api'.frontendbackendserversystemapi
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
namestringHuman-readable name for this SLA policy.
descriptionstringOptional description of when and why this SLA policy applies.
applies_tojsonThe ticket types this SLA policy governs. A policy may apply to multiple ticket types.
prioritystringThe ticket priority tier this policy applies to. Each priority level should have at most one active SLA policy per ticket type.
first_response_minutesnumberTarget number of minutes from ticket creation to first agent response. The SLA clock starts at ticket creation.
resolution_minutesnumberTarget number of minutes from ticket creation to full resolution.
business_hours_onlybooleanWhen true, the SLA clock pauses outside of the tenant's configured business hours and on public holidays.
statusstringWhether this policy is currently enforced. Inactive policies are retained for historical reference.
bodystringFull policy text (markdown).
versionstringPolicy version identifier (e.g. 1.2.0).
categoryenumPolicy domain / category.securityprivacyhrcompliancefinanceoperationsother
owner_iduuidPolicy owner (user id).
published_atdate-timeTimestamp the policy was published.
next_review_atdate-timeTimestamp the policy is next due for review.
tagsjsonFree-form tags for categorizing the policy.