PearPear
API IntegrationAPI SpecificationAuthentication

Start linking an X account

Returns the X authorization URL to send the browser to. The flow finishes at the callback below, which returns the browser to `returnTo`.

POST
/auth/link/x/start

Authorization

bearer
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Start of the X account link flow

Response Body

application/json

curl -X POST "https://example.com/auth/link/x/start" \  -H "Content-Type: application/json" \  -d '{}'
{  "authorizeUrl": "string"}

Link wallet to authenticated account POST

Attach wallet credentials to an already authenticated user account

Finish linking an X account GET

Redirect target for X. Always redirects to the frontend with a status, never renders an error. Takes no credential: the `state` parameter is what identifies the account, and it is unguessable, single-use and minted only by an authenticated start.