List machine authenticators for a user

GET 
/api/web/v1/users/:userid/machines

List all machine authenticators for the specified user. Caller requires the USERMACHINES:VIEW permission.

Request

Path Parameters

userid stringrequired

The UUID of the user for which machine authenticators are to be fetched.

Responses

200

Successful

application/json

Schema

Schema

• Array [

expiryTime date-time

When this machine secret expires in UTC time

id stringrequired

Identifies the device/machine

label stringrequired

Identifies the device/machine from the end-user point of view

lastUsedTime date-time

When this machine secret was last used

registrationTime date-timerequired

When this machine secret was created in UTC time

• ]

Example (from schema)

[
  {
    "expiryTime": "2019-02-19T13:15:27Z",
    "id": "string",
    "label": "string",
    "lastUsedTime": "2019-02-19T13:15:27Z",
    "registrationTime": "2019-02-19T13:15:27Z"
  }
]

400

Bad Request

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

401

Access denied

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

403

Forbidden

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

404

Not Found

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

409

Conflict

application/json

Schema

Schema

errorCode string

Error Codes specific to cause of failure.

errorMessage string

Additional Error Message describing the error.

parameters object[]

Optional additional error information.

Example (from schema)

{
  "errorCode": "invalid_user_response",
  "errorMessage": "Application id cannot be null",
  "parameters": [
    {}
  ]
}

Loading...