POST /deactivate

POSThttps://verify.web3.market/deactivateLicense Key30 requests/min

Remove a domain from a license key. The domain will no longer pass verification for this license.

Use Case

Deactivation is used when you need to move a deployment to a different domain. Since each license has a maximum number of activated domains, deactivating an old domain frees up a slot for a new one.

Common scenarios:

Migrating from a staging domain to a production domain
Switching to a new domain name
Switching your deployment to a different domain
Cleaning up test activations

Request Body

Body Parameters

Parameter	Type	Description
`license_key`*	string	The license key to deactivate the domain from. `Example: LIC-A3F9-K2M7-P8X1-Q4R6`
`domain`*	string	The domain to remove from this license. Automatically normalized. `Example: old-site.example.com`

Example Request

curl -X POST https://verify.web3.market/deactivate \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "license_key": "LIC-A3F9-K2M7-P8X1-Q4R6",
    "domain": "old-site.example.com"
  }'

Success Response

Status: 200 OK

{
  "success": true,
  "message": "Domain deactivated successfully.",
  "domain": "old-site.example.com",
  "license_key": "LIC-A3F9-K2M7-P8X1-Q4R6"
}

After deactivation, the domain will immediately fail verification calls. Any deployed dApp on that domain will receive {"valid": false, "error": "invalid_domain"} from the /verify endpoint.

Error Responses

Invalid License Key

Status: 404 Not Found

{
  "success": false,
  "error": "invalid_key",
  "message": "The provided license key does not exist."
}

Domain Not Found

Status: 422 Unprocessable Entity

{
  "success": false,
  "error": "domain_not_found",
  "message": "The specified domain is not activated on this license."
}

This error occurs when the domain you are trying to deactivate was never activated on the given license key, or was already deactivated.

Typical Workflow

A common workflow for moving a deployment to a new domain:

# 1. Deactivate the old domain
curl -X POST https://verify.web3.market/deactivate \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "LIC-A3F9-K2M7-P8X1-Q4R6",
    "domain": "old-site.example.com"
  }'
 
# 2. Activate the new domain
curl -X POST https://verify.web3.market/activate \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "LIC-A3F9-K2M7-P8X1-Q4R6",
    "domain": "new-site.example.com"
  }'
 
# 3. Verify the new domain works
curl "https://verify.web3.market/verify?license_key=LIC-A3F9-K2M7-P8X1-Q4R6&domain=new-site.example.com"

Deactivation takes effect immediately. Once a domain is deactivated, any running dApp on that domain will fail its next verification call. Make sure you have deployed to the new domain before deactivating the old one if you need zero downtime.

GET /verify GET /status