Get an authentication session

GET 
/:handle/:session_id

The session can be related to a signature or a mutual authentication

Request

Path Parameters

handle stringrequired

Org handle

Responses

200

OK

application/json

Schema

Schema

data

object

fields

object[]

Fields the receiver has to fill in

Array [

description string

format string

name string

type string

]

nacl string

Salt used for hashing the plaintext

subject string

Optional subject

ttl_ms integer

Milliseconds left until it expires

type string

Type of session, can be a signature (sig) OR a mutual authentication (auth)

success boolean

Example (from schema)

{
  "data": {
    "fields": [
      {
        "description": "string",
        "format": "string",
        "name": "string",
        "type": "string"
      }
    ],
    "nacl": "string",
    "subject": "string",
    "ttl_ms": 0,
    "type": "string"
  },
  "success": true
}

400

Bad Request

application/json

Schema

Schema

data integer[]
detail string

Human-friendly description that can be shown to the user.

error_code string
error_id string

Only present in case of internal errors (status 500 or 502)

Example (from schema)

{
  "data": [
    0
  ],
  "detail": "string",
  "error_code": "string",
  "error_id": "string"
}

404

Not Found

application/json

Schema

Schema

data integer[]
detail string

Human-friendly description that can be shown to the user.

error_code string
error_id string

Only present in case of internal errors (status 500 or 502)

Example (from schema)

{
  "data": [
    0
  ],
  "detail": "string",
  "error_code": "string",
  "error_id": "string"
}

500

Internal Server Error

application/json

Schema

Schema

data integer[]
detail string

Human-friendly description that can be shown to the user.

error_code string
error_id string

Only present in case of internal errors (status 500 or 502)

Example (from schema)

{
  "data": [
    0
  ],
  "detail": "string",
  "error_code": "string",
  "error_id": "string"
}

Loading...