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

Get your sign-in limits

How long you stay signed in to the Control Panel before you are asked to sign in again, how long a trusted browser skips your two-factor code, and the values you can choose. These are your own settings, whatever company the token works in.

GET/api/user/sign-in-settings

Returns

200 Your sign-in limits.

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.

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.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/user/sign-in-settings \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "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": true,
    "key": "8h",
    "label": "8 hours",
    "minutes": 480
  },
  "staff_cap": false,
  "two_factor_trust": {
    "applies": true,
    "default": true,
    "key": "8h",
    "label": "8 hours",
    "minutes": 480
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT