Skip to main content

MagicLinkApi

MethodHTTP requestDescription
createMagicLinkUsingPUTPUT /api/web/v1/users/{userid}/magiclinkCreate and get the Magic Link for a user
deleteMagicLinkUsingDELETEDELETE /api/web/v1/users/{userid}/magiclinkDelete the Magic Link for a given user
getMagicLinkUsingGETGET /api/web/v1/users/{userid}/magiclinkGet the Magic Link for a user

createMagicLinkUsingPUT

MagicLinkResponse createMagicLinkUsingPUT(userid, magicLinkCreateParms)

Create and get the Magic Link for a user

Create and get the Magic Link for the specified user. Caller requires the MAGICLINKS:ADD permission.

Parameters

NameTypeDescriptionNotes
useridString
magicLinkCreateParmsMagicLinkCreateParms

Return type

MagicLinkResponse

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

deleteMagicLinkUsingDELETE

deleteMagicLinkUsingDELETE(userid)

Delete the Magic Link for a given user

Delete the Magic Link for the specified user. Caller requires the MAGICLINKS:REMOVE permission.

Example

Parameters

NameTypeDescriptionNotes
useridStringThe UUID of the user to delete the Magic Link for.

Return type

null (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

getMagicLinkUsingGET

MagicLink getMagicLinkUsingGET(userid)

Get the Magic Link for a user

Get information about the Magic Link for the specified user if one has been created. Caller requires the MAGICLINKS:VIEW permission.

Example

Parameters

NameTypeDescriptionNotes
useridString

Return type

MagicLink

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-