MachineAuthApi
| Method | HTTP request | Description |
|---|---|---|
| createMachineAuthenticatorUsingPOST | POST /api/web/v1/users/{userid}/machines | Create a Machine Authenticator |
| deleteMachineAuthenticatorUsingDELETE | DELETE /api/web/v1/users/{userid}/machines/{id} | Delete a Machine Authenticator |
| listMachineAuthenticatorsUsingGET | GET /api/web/v1/users/{userid}/machines | List machine authenticators for a user |
createMachineAuthenticatorUsingPOST
MachineAuthenticatorRegistrationResult createMachineAuthenticatorUsingPOST(userid, machineAuthenticatorRegistration)
Create a Machine Authenticator
Create a Machine Authenticator for a user. Caller requires the USERMACHINES:ADD permission.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | String | The UUID of the user for which the machine authenticator is to be added. | |
| machineAuthenticatorRegistration | MachineAuthenticatorRegistration |
Return type
MachineAuthenticatorRegistrationResult
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
deleteMachineAuthenticatorUsingDELETE
deleteMachineAuthenticatorUsingDELETE(userid, id)
Delete a Machine Authenticator
Deletes a Machine Authenticator from a user. Caller requires the USERMACHINES:REMOVE permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | String | The UUID of the user from which the machine authenticator is to be deleted. | |
| id | String | The UUID of the machine authenticator which is to be deleted. |
Return type
null (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
listMachineAuthenticatorsUsingGET
List<UserMachineAuthenticator> listMachineAuthenticatorsUsingGET(userid)
List machine authenticators for a user
List all machine authenticators for the specified user. Caller requires the USERMACHINES:VIEW permission.
Example
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | String | The UUID of the user for which machine authenticators are to be fetched. |
Return type
List<UserMachineAuthenticator>
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |