Create a dispatch target
POST/nevisfido/token/dispatch/targets
This is a proprietary nevisFIDO API — not part of the FIDO UAF standard — used to register a new dispatch target for a given user. A dispatch target represents a delivery destination, such as a mobile device receiving push notifications or an email address, to which nevisFIDO can send operation tokens during a FIDO UAF authentication or registration flow. Each dispatch target is associated with a public key (in JWK format) that nevisFIDO uses to verify device-signed requests for subsequent modifications. On success, the server assigns the target a unique identifier that must be referenced when dispatching tokens or managing the target through other Dispatch Target Service endpoints.
Request
Responses
- 201
- 400
- 401
- 403
- 405
- 406
- 415
- 422
- 500
Created The server successfully created the dispatch target. The response body contains id (the internal dispatch target identifier) and extId (the external identifier).
Bad Request The provided payload is not properly formatted.
Unauthorized The request was not authorized. There is an invalid SecToken or unresolved username.
Forbidden The user is not found in the credential repository based on the provided username.
Method Not Allowed The method of the received request was not POST.
Not Acceptable The provided Accept header forbids application/json content.
Unsupported Media Type The Content-Type header is not properly set to application/json;charset=UTF-8.
Unprocessable Entity The request could not be processed. For example, because the name of the provided dispatch target is already in use by another dispatch target of the user, or because the specified dispatcher is not configured.
Internal Server Error The server could not process the request because of an unexpected error.