Skip to main content
POST
Sign in and get a token

Body

application/json
email
string<email>
required

The same email you use to sign in to Cloud Chat.

Example:

"you@company.com"

password
string<password>
required

Your password. It travels only on this call and is never logged.

Example:

"••••••••"

Response

Either a token, or a challenge to answer before one is issued.

Sign-in completed.

id_token
string
required

Send THIS one as Authorization: Bearer <id_token>. It carries the identity the APIs authorize on — your email and the accounts your credentials cover. The access token does not.

Example:

"eyJraWQiOiJhYmMxMjMiLCJhbGciOiJSUzI1NiJ9..."

access_token
string
required

Issued by Cognito alongside the id token. Not what the Cloud Humans APIs read.

Example:

"eyJraWQiOiJkZWY0NTYiLCJhbGciOiJSUzI1NiJ9..."

expires_in
integer
required

Lifetime in seconds.

Example:

3600

token_type
string
required

Always Bearer.

Example:

"Bearer"