Link new authentication with current user

POST 
/auth/api/login/registration/self-link

Authorization: apiKey

name: bearertype: apiKeyscheme: bearerbearerFormat: JWTdescription: Access token provided after running the oauth flow (and if needed registering/linking)

Links a new authentication with a strategy instance with the currently logged in user. For future logins using that authentication the user will be directly found

A (still) valid registration token is needed. After a successful linking, the expiration of the activeLogin and loginData will be updated accoringly

Request

application/json

Body

required

register_token stringrequired

The register token issued during as result of the oauth registration flow. Scope of the token must contain "login-register".

Must be given.

Responses

200

If successful, the default response with operation 'self-link'

application/json

Schema

Schema

operation stringrequired

A string representation of the operation performed

result stringrequired

Possible values: [success, failed]

Default value: success

The result of the operation. Defaults to "success"

time date-timerequired

Default value: 2025-04-20T18:03:54.598Z

The time the operation was performed. Defaults to the current date+time

Example (from schema)

{
  "operation": "self-register",
  "result": "success",
  "time": "2025-04-20T18:05:34.780Z"
}

201

application/json

Schema

Schema

operation stringrequired

A string representation of the operation performed

result stringrequired

Possible values: [success, failed]

Default value: success

The result of the operation. Defaults to "success"

time date-timerequired

Default value: 2025-04-20T18:03:54.598Z

The time the operation was performed. Defaults to the current date+time

Example (from schema)

{
  "operation": "self-register",
  "result": "success",
  "time": "2025-04-20T18:05:34.781Z"
}

401

If no user is logged in , the given registration token is not/no longer valid or the registration time frame has expired

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'https://ccims.github.io/auth/api/login/registration/self-link' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "register_token": "registration.token.jwt"
}'

Request Collapse all

Auth

bearer

Body required

{
  "register_token": "registration.token.jwt"
}

ResponseClear

Click the Send API Request button above and see the response here!