SynqDocs
Management APICustom sign-in providers

Delete one of a brand's own sign-in providers

Deletes it, its app's sealed secret and every linked account there: people keep their accounts and their other ways in, and someone whose only way in it was signs in no more until the tenant gives them another. It comes off every app's list of ways (`sign_in_methods`) that names it, each recorded as that app's `app.updated`; while an app takes no other way, the delete is refused (409 `sign_in_method_in_use`, naming them in `apps`) and nothing changes. Its id is free again, and a provider made with it starts with nobody, is on no app's list and is off on the brand's sign-in page. The brand's last way to sign in that's on can't be deleted (422 `no_way_to_sign_in`). Needs `org.connections.edit`. Recorded as `brand.updated` with `deleted`, `identities_removed` and, where apps named it, `apps_updated`.

DELETE/v1/orgs/{org}/brands/{brand}/custom-sign-in-providers/{provider}

Deletes it, its app's sealed secret and every linked account there: people keep their accounts and their other ways in, and someone whose only way in it was signs in no more until the tenant gives them another. It comes off every app's list of ways (sign_in_methods) that names it, each recorded as that app's app.updated; while an app takes no other way, the delete is refused (409 sign_in_method_in_use, naming them in apps) and nothing changes. Its id is free again, and a provider made with it starts with nobody, is on no app's list and is off on the brand's sign-in page. The brand's last way to sign in that's on can't be deleted (422 no_way_to_sign_in). Needs org.connections.edit. Recorded as brand.updated with deleted, identities_removed and, where apps named it, apps_updated.

Authorization

bearer
AuthorizationBearer <token>

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

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$
brand*string

The brand's id

Match^brd_[0-9a-hjkmnp-tv-z]{26}$
provider*string

The brand's own provider's id

Match^custom-[a-z0-9]([a-z0-9-]{0,23}[a-z0-9])?$

Response Body

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X DELETE "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/brands/brd_01h455vb4pex5vsknk084sn02q/custom-sign-in-providers/custom-acme-guild" \  -H "Authorization: Bearer $SYNQ_API_KEY"
Empty