跳到主要内容

unlinkThirdPartyAccount

unlinkThirdPartyAccount(provider)

DELETE /api/2.0/people/thirdparty/unlinkaccount

Unlink a third-party account

Removes the link between the calling profile and the named third-party provider, so that the account can no longer sign in through it. It acts on the authenticated account only and takes the provider name in the query, using the same lowercase values GET api/2.0/people/thirdparty/providers returns, such as google or microsoft. The call returns no body and is idempotent: unlinking a provider that is not linked answers 200 and changes nothing. The portal profile itself is kept, together with its password, so the account stays usable through the ordinary sign-in; only the third-party route is removed. Link the provider again through PUT api/2.0/people/thirdparty/linkaccount.

Parameters​

NameInTypeDescriptionNotes
providerqueryStringThe name of the provider to unlink, in the lowercase form GET api/2.0/people/thirdparty/providers returns, such as google or microsoft. A name that is not linked to the calling profile is accepted and changes nothing.[optional] [example: google]

Responses​

Status codeDescriptionTypeResponse headers
200The third-party identity is no longer linked to the calling profile. No content is returned-X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
401UnauthorizedErrorApiResponse-
429Too Many Requests.ErrorApiResponseRetry-After
500Internal Server Error.ErrorApiResponse-
400Bad Request.ErrorApiResponse-
502Bad Gateway. Returned by the reverse proxy, response body may be HTML and not JSON.--
503Service Unavailable. Returned by the reverse proxy, response body may be HTML and not JSON.--

Return type​

null (empty response body)

Authorization​

Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json