Imsg-service

/imsg-service/v1/callback

GET https://[SERVICE URL].com/imsg-service/v1/callback

Callback from IMAS login

Query Parameters

Name	Type	Description
imid_token	string	IM ID JWT
serviceCallback	string	Where to redirect client after login

302

"Redirected to the service callback url"

/imsg-service/v1/health

GET https://[SERVICE URL].com/imsg-service/v1/health

Health status

200

{
  "inGrace": false,
  "stateChecksum": "A checksum string"
}

500

{
  "inGrace": false,
  "stateChecksum": "No checksum string"
}

/imsg-service/v1/login

GET https://[SERVICE URL].com/imsg-service/v1/login

Trigger login flow

Query Parameters

Name	Type	Description
callback*	string	Where to redirect client after login
org*	string	Which org to login with

302

"Redirected after login"

/imsg-service/v1/token-is-set

GET https://[SERVICE URL].com/imsg-service/v1/token-is-set

Check if request contains IMID token

200

{
  "msg": "ok"
}

401

"errors.auth.MissingToken"

/imsg-service/v1/units

GET https://[SERVICE URL].com/imsg-service/v1/units

List all units a subject belongs to

200

{
  "msg": "Unit set"
}

403

"errors.auth.Forbidden"

/imsg-service/v1/org/{org}/login

GET https://[SERVICE URL].com/imsg-service/v1/org/{org}/login

Trigger login flow

Query Parameters

Name	Type	Description
callback*	string	Where to redirect client after login

302

"Redirected after login"

/imsg-service/v1/logout

POST https://[SERVICE URL].com/imsg-service/v1/logout

Log out

Query Parameters

Name	Type	Description
callback	string	Where to redirect client after logout

200

{
  "msg": "You are logged out"
}

/imsg-service/v1/unit

POST https://[SERVICE URL].com/imsg-service/v1/unit

Set preferred unit

Request Body

Name	Type	Description
unit	string	Preferred unit

200

{
  "msg": "Unit set"
}

403

"errors.auth.Forbidden"