Users
Add Oauth2 Identity
Adds an OAuth2 identity to the user, so that they can be logged in with that identity. You need to send the OAuth code or the access token to this endpoint.
POST
- If no access token is provided, it will use your OAuth2 token URL to exchange the given code for an access token.
- Then it will use the access token (given by you, or received from step 1) to look up the user on your service using the lookup URL, and expects a JSON object in response with an id property.
- It will then save that user id to the user in our db as a new OAuthIdentity.
In this example, we call your lookup URL (let’s say,
https://oauth.provider/user?t=<%= accessToken %>
) with the access token
(1234). The lookup URL returns { id: 'abcd' }
in this case, which we save to
the user in our db.
Authorizations
Basic authentication header of the form Basic <encoded-value>
, where <encoded-value>
is the base64-encoded string username:password
.
Path Parameters
The document's _id
or slug
.
Body
application/json
Response
200 - application/json
The affected user
Subset of properties listed here