List a brand's own sign-in providers
The OpenID Connect and OAuth 2.0 providers the brand added, in the order they were added, a page at a time (50 by default): each one's settings, the redirect URI its app registers and its app's client id, never a secret. Synq's own providers are at `…/sign-in-providers`. Needs `org.brands.view`.
/v1/orgs/{org}/brands/{brand}/custom-sign-in-providersThe OpenID Connect and OAuth 2.0 providers the brand added, in the order they were added, a page at a time (50 by default): each one's settings, the redirect URI its app registers and its app's client id, never a secret. Synq's own providers are at …/sign-in-providers. Needs org.brands.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}$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/custom-sign-in-providers" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "data": [ { "id": "custom-acme-guild", "type": "oidc", "name": "Acme", "icon": "string", "issuer": "string", "endpoints": { "authorization": "string", "token": "string", "userinfo": "string" }, "app": { "client_id": "app_01h455vb4pex5vsknk084sn02q", "token_endpoint_auth_method": "client_secret_basic", "updated_at": "2026-10-21T12:00:00.000Z" }, "redirect_uri": "https://acme.auth.synq.build/federation/custom-acme-guild/callback", "scopes": [ "string" ], "claims": { "subject": "string", "name": "Acme", "handle": "string", "picture": "string", "email": "ana@acme.example", "email_verified": "string" }, "email_authoritative": true, "use": "sign_in", "keep_tokens": true, "kept_claims": [ "string" ], "offered": true, "created_at": "2026-10-21T12:00:00.000Z" } ], "next_cursor": "string"}Get one of a brand's own sign-in providers GET
Its settings, the redirect URI its app registers and its client id, never a secret. Needs `org.brands.view`.
Change one of a brand's own sign-in providers PATCH
Its name and icon, an OAuth 2.0 provider's endpoints (where the app is asked again), the scopes, the claims it is read by, whether its email is authoritative, what it is for (`use`), and the tokens and claims kept (`keep_tokens` on wants a person's sign-in from the last 5 minutes, 403 `fresh_sign_in_required`). Its id, kind and issuer never change: add another provider instead. Its app is `PUT …/app`; turning it on or off is `POST …/enable` and `…/disable`. Needs `org.brands.edit`. Recorded as `brand.updated`, naming each setting under `custom_sign_in_provider.` (`keep_tokens` as `keeps_provider_access`, with `identities_cleared` when turning it off deleted some).