SynqDocs
Account APIIdentities

Confirm an account your server verified

Links a pending account (`GET /v1/pending-identities`) to the person, from the session of the app that made its code: it joins their account with the same id, as `GET /v1/identities` lists it, and is recorded as `user.identity_linked` with `by: app`. Where its provider makes sign-in links, the person is emailed that a way to sign in was added. One that isn't this session's, or that expired, is 404; a provider turned off since is 409 `sign_in_method_unavailable`; an account someone linked meanwhile is 409 `identity_in_use`; at 20 ways in and linked accounts, 409 `identity_limit_reached`. Needs `me:write`.

POST/v1/identities/{identity}/confirm

Links a pending account (GET /v1/pending-identities) to the person, from the session of the app that made its code: it joins their account with the same id, as GET /v1/identities lists it, and is recorded as user.identity_linked with by: app. Where its provider makes sign-in links, the person is emailed that a way to sign in was added. One that isn't this session's, or that expired, is 404; a provider turned off since is 409 sign_in_method_unavailable; an account someone linked meanwhile is 409 identity_in_use; at 20 ways in and linked accounts, 409 identity_limit_reached. Needs me:write.

Authorization

bearer
AuthorizationBearer <token>

An access token from this issuer for its account API (resource=<issuer>/me).

In: header

Path Parameters

identity*string

The pending identity's id

Match^idn_[0-9a-hjkmnp-tv-z]{26}$

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.auth.synq.build/me/v1/identities/idn_01h455vb4pex5vsknk084sn02q/confirm" \  -H "Authorization: Bearer $ACCESS_TOKEN"
{  "id": "idn_01h455vb4pex5vsknk084sn02q",  "provider": "google",  "subject": "string",  "handle": "ada",  "email": "ada@example.com",  "password": true,  "provider_user_id": "987654321",  "scopes": [    "phone"  ],  "unconfirmed_scopes": [    "telegram:bot_access"  ],  "has_picture": true,  "added_by": "person",  "created_at": "2026-10-21T12:00:00.000Z",  "last_used_at": "2026-10-21T12:00:00.000Z"}