Identify with company context

POST

/portal/{companyCodeContext}/identify

curl --request POST \
  --url https://auth.timetonic.com/portal/COMPANY_A/identify \
  --header 'Content-Type: application/json' \
  --data '{ "userId": "user@example.com" }'

Pre-login identification within company context

Parameters

Path Parameters

companyCodeContext

required

string

Example

COMPANY_A

Company account code for portal-scoped requests

Request Body^required

Media typeapplication/json

object

userId

required

User identifier (email, username, or external ID)

string

Example

user@example.com

Responses

200

User identification data

Media typeapplication/json

object

ssoUrl

One of:

string

string format: uri

boolean

boolean

ssoOnly

Whether SSO is the only allowed authentication method

boolean

twoFactor

Whether user has 2FA enabled

boolean

tcVersion

User’s accepted T&C version, null if not accepted

string

nullable

Example

{
  "ssoUrl": "/saml/tenant-key/login",
  "ssoOnly": false,
  "twoFactor": true,
  "tcVersion": "1.0"
}

422

Validation error

Media typeapplication/json

object

success

boolean

error

string

message

string

errors

object

key

additional properties

Array<string>

Example

{
  "success": false,
  "error": "validation_error",
  "message": "The given data was invalid",
  "errors": {
    "email": [
      "The email field is required."
    ]
  }
}