CorefinityCorefinityDocs
Open the Control PanelControl Panel
Account security · 2 of 5

Update your sign-in limits

Changes one or both limits, at once and everywhere you are signed in. Lowering the session limit below your two-factor trust lowers the trust with it, and trust_lowered says so. Lengthening either limit is never saved from the API: it is refused 409 confirmation_required with a confirm_url, where you confirm it is you in the Control Panel.

PATCH/api/user/sign-in-settings

Body

session_limitstring or any or null

How long you stay signed in. null leaves it as it is.

two_factor_truststring or any or null

How long a trusted browser skips your two-factor code. null leaves it as it is.

Returns

200 Your sign-in limits as they are now.

Fields of the 200 answer
choicesarray of objectsRequired

The values you can choose, shortest first.

Fields of each item
keystringRequired

A length of time, as its key.

8h16h1d3d7d
labelstringRequired

The length in words, such as 16 hours.

minutesintegerRequired
session_limitobjectRequired

How long you stay signed in, counted from the moment you sign in.

Fields
keystringRequired

A length of time, as its key.

8h16h1d3d7d
labelstringRequired

The length in words, such as 16 hours.

minutesintegerRequired
defaultbooleanRequired

Whether you have never chosen a value, so the default applies.

staff_capbooleanRequired

Always false for customers and agencies.

two_factor_trustobjectRequired

How long a trusted browser skips your two-factor code. Never longer than session_limit.

Fields
keystringRequired

A length of time, as its key.

8h16h1d3d7d
labelstringRequired

The length in words, such as 16 hours.

minutesintegerRequired
appliesbooleanRequired

Whether you have two-factor authentication on. Without it no browser can be trusted.

defaultbooleanRequired

Whether you have never chosen a value, so the default applies.

trust_loweredbooleanRequired

Whether the two-factor trust was lowered to follow the session limit down.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404feature_offThis feature is not on for your organisation yet.
409confirmation_requiredStaying signed in longer needs you to confirm it is you. Confirm it in the Control Panel, then try again.
422invalidFix the field named in field; errors says why.
422trust_above_session_limitA trusted browser cannot skip the code for longer than you stay signed in. Choose a shorter time for the trusted browser, or a longer sign-in.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X PATCH https://manage.corefinity.com/api/user/sign-in-settings \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "session_limit": "1d",
    "two_factor_trust": "8h"
  }'
{
  "choices": [
    {
      "key": "8h",
      "label": "8 hours",
      "minutes": 480
    },
    {
      "key": "16h",
      "label": "16 hours",
      "minutes": 960
    },
    {
      "key": "1d",
      "label": "1 day",
      "minutes": 1440
    },
    {
      "key": "3d",
      "label": "3 days",
      "minutes": 4320
    },
    {
      "key": "7d",
      "label": "7 days",
      "minutes": 10080
    }
  ],
  "session_limit": {
    "default": false,
    "key": "16h",
    "label": "16 hours",
    "minutes": 960
  },
  "staff_cap": false,
  "trust_lowered": true,
  "two_factor_trust": {
    "applies": true,
    "default": false,
    "key": "16h",
    "label": "16 hours",
    "minutes": 960
  }
}
Try it

Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT