Redeem a link token
POST/v1/assistant/link
Redeems a link token and creates the grant, binding the channel identity the token carries to the authenticated account. The identity is read from the token server-side — nothing in this request can point the link at a different one. The token is the idempotency key: it is single-use, so a replay of this request fails rather than creating a second grant.
Request
Responses
- 201
- 400
- 401
- 409
Grant created. The Assistant answers that identity from the next message on.
The token is missing, unknown, expired, or already redeemed (invalid_token / expired_token).
Missing or invalid credentials.
The identity is already linked to an account (identity_already_linked). One channel identity operates one naturali account: re-pointing it means revoking the existing grant first, which is explicit and auditable rather than silent.