---
title: "Update organization session policy"
method: PATCH
path: "/api/v1/organizations/{organization_id}/session-policy"
tags: ["Organizations"]
---

# Update organization session policy

`PATCH /api/v1/organizations/{organization_id}/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.

## Path parameters

- `organization_id` string, required

## Request body

- OrganizationServiceUpdateOrganizationSessionPolicyBody
  - `absolute_session_timeout` integer — 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_timeout` integer — 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_enabled` boolean — Whether idle session timeout is enabled. Omit when policy_source is APPLICATION.
  - `idle_session_timeout_unit` 'MINUTES' | 'HOURS' | 'DAYS'
  - `policy_source` 'APPLICATION' | 'CUSTOM'

## Response `200`

Session policy updated successfully.

- OrganizationsUpdateOrganizationSessionPolicyResponse
  - `policy` OrganizationsOrganizationSessionPolicySettings
    - `absolute_session_timeout` integer — The absolute session timeout value. The unit is specified by absolute_session_timeout_unit. Omitted when policy_source is 'environment'.
    - `absolute_session_timeout_unit` 'MINUTES' | 'HOURS' | 'DAYS'
    - `idle_session_timeout` integer — The idle session timeout value. The unit is specified by idle_session_timeout_unit. Omitted when idle_session_timeout_enabled is false or policy_source is 'environment'.
    - `idle_session_timeout_enabled` boolean — Whether idle session timeout is enabled for this organization. Omitted when policy_source is 'environment'.
    - `idle_session_timeout_unit` 'MINUTES' | 'HOURS' | 'DAYS'
    - `policy_source` 'APPLICATION' | 'CUSTOM'

## Other responses

- `404` — Organization not found.

---

[API](https://skmtc.dev/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.dev/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/revisions/a7181708713b/schema)