Britive platform release 2026.09.02 is now live in production.

Manage global session settings

Prev Next
Post
/api/settings/login

Update the session and token lifetimes that apply tenant-wide. Omit a field to leave its stored value unchanged. The full settings object is returned.

Security
HTTP
Type bearer
Body parameters

Information to manage global session settings

{
  "sessionTimeoutInHours": 4,
  "applicationTokenTimeoutInHours": 336,
  "temporaryTokenTimeoutInHours": 4
}
object
Example{ "sessionTimeoutInHours": 4, "applicationTokenTimeoutInHours": 336, "temporaryTokenTimeoutInHours": 4 }
sessionTimeoutInHours
integer (int32)

Global session lifetime, 1 to 12 hours.

Minimum1
Maximum12
applicationTokenTimeoutInHours
integer (int32)

Lifetime of application tokens, 1 to 720 hours.

Minimum1
Maximum720
temporaryTokenTimeoutInHours
integer (int32)

Lifetime of temporary tokens, 1 to 24 hours. This is both the maximum a caller may request and the lifetime granted when a request names no duration.

Minimum1
Maximum24
Responses
200

Global session settings updated successfully

object
Example{ "sessionTimeoutInHours": 4, "applicationTokenTimeoutInHours": 336, "temporaryTokenTimeoutInHours": 4 }
sessionTimeoutInHours
integer (int32)

Global session lifetime, 1 to 12 hours.

Minimum1
Maximum12
applicationTokenTimeoutInHours
integer (int32)

Lifetime of application tokens, 1 to 720 hours.

Minimum1
Maximum720
temporaryTokenTimeoutInHours
integer (int32)

Lifetime of temporary tokens, 1 to 24 hours. This is both the maximum a caller may request and the lifetime granted when a request names no duration.

Minimum1
Maximum24
400

A supplied value is outside its permitted range