REST API

GET /v1/session

Describe this session

GET /v1/session

This process's workspace/account and unlocked security groups, plus the caller's own mTLS identity.

Responses #

  • 200 Successful Response

    • workspace_id string required
    • account_id string required
    • security_groups string[] required
    • client object required

      The mTLS identity of the caller, as `GET /v1/session` reports it.

  • 401 No client certificate reached this route (`client_certificate_required`).

    • error object required

      The body of every non-2xx response: what went wrong, for a program and for a person.

  • 403 The client certificate's CN is not in `DIAGNOS_API_ALLOWED_CLIENT_CN` (`client_certificate_cn_not_allowed`).

    • error object required

      The body of every non-2xx response: what went wrong, for a program and for a person.

curl --cert client.crt --key client.key \
  -X GET "https://api.imgexam.com/v1/session" \
  -H "Content-Type: application/json"
{
  "workspace_id": "string",
  "account_id": "string",
  "security_groups": [
    "string"
  ],
  "client": {
    "common_name": "string",
    "serial": "string"
  }
}