Create a human ownership policy revision
The account-scoped human ownership policy. Every account member can read it; only administrators can write it. POST appends an immutable revision and returns that revision with its author and timestamp. Fields omitted from POST carry forward; explicit null clears nullable wait/alert minute settings. There is no update or delete operation for past revisions. Every successful call creates the next revision, even if settings are unchanged. Administrators only. alert_enabled requires alert_minutes; alert_minutes must be less than wait_trigger_minutes when both are set. Invalid values or combinations return a field-level 422 and create no revision. A sent recipient list must contain at most 50 distinct positive integer IDs, all members of this account; a removed member in the carried-over list returns stale_recipients until a fresh list is supplied. Wrong value types return invalid_params.
Authorizations
This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.
Path Parameters
The numeric ID of the account
Body
How long the agent stays quiet after a teammate replies; 15 minutes through 7 days. Default 720.
15 <= x <= 10080Whether the agent automatically takes the conversation back.
Optional customer-wait trigger, 5–1440 minutes; null disables it. Inert when auto_return is false.
5 <= x <= 1440Whether to alert selected account members when the customer has waited.
Optional alert delay, 5–1440 minutes; null disables it. Required when alert_enabled is true and must be less than wait_trigger_minutes when both are set.
5 <= x <= 1440Array of positive user IDs that belong to this account. At most 50 distinct members are stored; repeated IDs are normalized to one sorted entry.
x >= 1Agent behavior when it returns.
answer, answer_with_follow_up, escalate Optional change reason; at most 500 characters.
500Response
The newly appended revision. This operation does not edit an existing revision.
Current revision number; 0 means the account has not saved a revision.
How long the agent stays quiet after a teammate replies; 15 minutes through 7 days. Default 720.
15 <= x <= 10080Whether the agent automatically takes the conversation back. Default true.
Optional customer-wait trigger, 5–1440 minutes; null disables it. Default null. Inert when auto_return is false.
5 <= x <= 1440Whether to alert selected account members when the customer has waited. Default false.
Optional alert delay, 5–1440 minutes; null disables it. Default null. Required when alert_enabled is true and must be less than wait_trigger_minutes when both are set.
5 <= x <= 1440Up to 50 distinct IDs of members of this account. Stored sorted and unique. Default empty list.
50x >= 1Agent behavior when it returns: answer (default), answer_with_follow_up, or escalate.
answer, answer_with_follow_up, escalate Optional change reason; at most 500 characters and must not contain a NUL byte. Default null.
500Time the current revision was created; null for revision 0.
Author if still a member of the account, otherwise null.
Revision this version follows; null for revision 1.
administrator, system