API - Domain Management
Common Identity helps organizations prove they own certain domains. Organizations can verify a domain and claim ownership of it. Verifying a domain ensures that a user in a given organization belongs to that specific domain. You can verify domains in three steps:
Get a verification token using the 'GetToken' API.
Add the received verification token as a 'TXT' record for the specific domain to your DNS server.
Call the CI API to verify domain ownership.
After verification, you can claim the domain using the 'Claim Domain' API.
If you need to release previously claimed domains, you can use the 'Unclaim Domain' API. This API lets an organization give up its claim on a domain, so the domain won't be marked as 'claimed' by that organization anymore. However, releasing a claim doesn't change the verification status of the domain. Even after being unclaimed, the domain stays verified, showing that its ownership and control were successfully validated during the original verification process.
If you want to remove both the claim and the verification status, you'll need to use a different API. To unverify domains for the organization, you can use the 'Unverify' API. This API invalidates the domain’s verification, meaning the domain is no longer considered verified by the system.