List a user's linked accounts
Every way the user signs in or has linked, oldest first, a page at a time (50 by default): each provider account with what the provider said of it, the extra scopes granted, the claims the brand keeps (`kept_claims`) and whether Synq keeps their tokens there (`provider_tokens`, without the tokens), and their wallets and email address. Passkeys are at `…/passkeys`. Needs `org.users.view`.
/v1/orgs/{org}/brands/{brand}/users/{user}/identitiesEvery way the user signs in or has linked, oldest first, a page at a time (50 by default): each provider account with what the provider said of it, the extra scopes granted, the claims the brand keeps (kept_claims) and whether Synq keeps their tokens there (provider_tokens, without the tokens), and their wallets and email address. Passkeys are at …/passkeys. Needs org.users.view.
Authorization
bearer An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.
In: header
Path Parameters
The org's id
^org_[0-9a-hjkmnp-tv-z]{26}$The brand's id
^brd_[0-9a-hjkmnp-tv-z]{26}$The user's id
^usr_[0-9a-hjkmnp-tv-z]{26}$Query Parameters
At most this many items, 200 at the most.
1 <= value <= 20050The previous page's next_cursor, for the page after it.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/brands/brd_01h455vb4pex5vsknk084sn02q/users/usr_01h455vb4pex5vsknk084sn02q/identities" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "data": [ { "id": "idn_01h455vb4pex5vsknk084sn02q", "provider": "string", "subject": "string", "handle": "string", "details": { "account_type": "User", "created_at": "2011-01-25T18:44:36.000Z", "public_repos": 0, "followers": 0, "email_verified": true, "workspace_domain": "acme.example", "telegram_user_id": "987654321", "phone_number": "+15555550123", "phone_number_verified": true, "name": "Ada Lovelace", "test": true }, "details_read_at": "2026-10-21T12:00:00.000Z", "scopes": [ "phone" ], "unconfirmed_scopes": [ "telegram:bot_access" ], "last_used_at": "2026-10-21T12:00:00.000Z", "created_at": "2026-10-21T12:00:00.000Z", "added_by": "person", "claims": { "locale": "en-US" }, "provider_tokens": { "scope": "tweet.read users.read offline.access", "expires_at": "2026-10-21T12:00:00.000Z", "refreshable": true, "kept_at": "2026-10-21T12:00:00.000Z" }, "linked_at": "2026-10-21T12:00:00.000Z" } ], "next_cursor": "string"}Start an upload POST
Authorizes one upload for a purpose and answers where to PUT its bytes: a URL signed for 5 minutes, for exactly this type and length, straight to Synq's storage. Then call `…/finalize`. A brand has at most 5 uploads of a purpose waiting at once. `theme_background` needs a plan with the advanced theme (`branding.advanced_theme`), and `default_avatar` a plan with default avatars of the brand's own (`branding.default_avatars`, Pro and up). Needs `org.brands.edit`.
Read a user's access token at a provider POST
The person's access token at the provider of one of their linked accounts, for your server to call that provider's API as them, where the brand keeps tokens there (`keep_tokens`, through its own app). Synq refreshes it first when it expires within a minute and a refresh token is kept; the refresh token is never returned. Only an org API key, from a server: a person's access token, the dashboard's included, or a request with an `Origin` or `Sec-Fetch-Site` header (a browser's) is 403 `server_only`. Each read is recorded as `user.provider_token_read`; a refresh the provider refuses deletes the tokens, records `user.identity_token_revoked` and answers 409 `provider_token_revoked`. Limited per org. Needs `org.users.providerTokens.read`.