---
title: "POST /v2/me/wallet-link/preflight"
method: POST
path: "/v2/me/wallet-link/preflight"
tags: ["Identity"]
---

# POST /v2/me/wallet-link/preflight

`POST /v2/me/wallet-link/preflight`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/me/wallet-link/preflight`
- Auth: HTTP bearer

Checks a wallet-only Privy identity before profile or managed-wallet provisioning. A collision returns an opaque recovery token, the surviving account's available social login methods, and masked account and wallet hints.

## Request body

- object

## Response `200`

Wallet onboarding may continue, or an existing parent must be recovered

- union
  - object
    - `state` 'continue', required
  - object
    - `expires_at` string, date-time, required
    - `provider_hints` object, required
      - `google` string
      - `twitter` string
    - `providers` string[], required
    - `recovery_token` string, required
    - `state` 'recovery_required', required
    - `wallet_hint` string, required

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `403`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

[API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)