Single Sign-On
Delete SSO provider
Permanently delete an SSO provider and all its domain mappings.
DELETE /app/sso/providers/{providerId}
Permanently deletes an SSO provider, removes all its domain mappings, and deregisters the Cognito identity provider. Requires the SSO feature entitlement.
This action cannot be undone. Users who previously authenticated via this provider will no longer be able to sign in with SSO. Cognito cleanup is best-effort — if it fails, the provider record is still removed from the platform.
Path parameters
| Parameter | Description |
|---|---|
providerId | The UUID of the SSO provider. |
Request
See API Basics for required headers.
This endpoint takes no request body.
Sample request
curl -X DELETE https://api.statusdashboard.com/app/sso/providers/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "Authorization: Bearer bcf847abf5c6:def456"Sample response
Status: 204 No Content
No response body.
Error responses
| Status | When |
|---|---|
403 | SSO feature not enabled on the plan. |
404 | SSO provider not found or does not belong to the caller's organization. |