v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB

Organizations

Update organization session policy

Sets a custom session policy for an organization or reverts to application-level settings. Send session_policy='APPLICATION' to revert to application defaults. Send session_policy='CUSTOM' with timeout values to activate a custom policy.

patch/api/v1/organizations/{organization_id}/session-policy

Path parameters

organization_idstring required

The unique identifier of the organization whose session policy is being updated.

Request body

absolute_session_timeoutinteger

The absolute session timeout value. The unit is specified by absolute_session_timeout_unit. Omit when policy_source is APPLICATION.

absolute_session_timeout_unit'MINUTES' | 'HOURS' | 'DAYS'

idle_session_timeoutinteger

The idle session timeout value. The unit is specified by idle_session_timeout_unit. Omit when idle_session_timeout_enabled is false.

idle_session_timeout_enabledboolean

Whether idle session timeout is enabled. Omit when policy_source is APPLICATION.

idle_session_timeout_unit'MINUTES' | 'HOURS' | 'DAYS'

policy_source'APPLICATION' | 'CUSTOM'

Example request

{
  "absolute_session_timeout": 360,
  "idle_session_timeout": 84,
  "idle_session_timeout_enabled": true
}

Response

Session policy updated successfully.

Example response

{
  "policy": {
    "absolute_session_timeout": 360,
    "idle_session_timeout": 84,
    "idle_session_timeout_enabled": true
  }
}