Custom Domain

Verify custom domain DNS

get

Checks the DNS status of a custom domain in real time.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

domainNamestringRequired

Custom domain to verify

Responses

200

DNS status returned successfully

application/json

statusstringOptional

401

Authentication error

application/json

403

No permission

application/json

404

Domain not found

application/json

500

External API error

application/json

get

/customdomain/{domainName}/verify

HTTPcURLJavaScriptPython

GET /v2/customdomain/{domainName}/verify HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "domain": {
    "id": "example.com",
    "dns_status": "active",
    "valid": true,
    "message": "DNS is correctly configured",
    "app": {
      "id": "1719010867306",
      "name": "example.com",
      "online": true
    }
  }
}

Remove custom domain

delete

Removes a custom domain from the user and unlinks it from the app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

domainNamestringRequired

Custom domain to remove

Responses

200

Custom domain removed successfully

application/json

statusstringOptional

messagestringOptional

domainstringOptional

401

Authentication error

application/json

403

No permission

application/json

404

Domain not found

application/json

500

External API error

application/json

delete

/customdomain/{domainName}/remove

HTTPcURLJavaScriptPython

DELETE /v2/customdomain/{domainName}/remove HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Domain removed successfully",
  "domain": "example.com"
}

Edit custom domain link

put

Moves a custom domain to another app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

domainNamestringRequired

Custom domain to move

Body

application/json

newAppIDstringRequired

New app ID

Responses

200

Custom domain edited successfully

application/json

statusstringOptional

messagestringOptional

migratedbooleanOptional

domainstringOptional

400

Invalid operation

application/json

401

Authentication error

application/json

403

No permission

application/json

404

Domain or app not found

application/json

409

App already has another custom domain

application/json

500

Migration error

application/json

put

/customdomain/{domainName}/edit

HTTPcURLJavaScriptPython

PUT /v2/customdomain/{domainName}/edit HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "newAppID": "text"
}

{
  "status": "ok",
  "message": "Domain edited successfully",
  "migrated": false,
  "domain": "example.com"
}

List custom domains

get

Returns all custom domains of the authenticated user.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

List of custom domains returned successfully

application/json

anyOptional

401

Authentication error

application/json

get

/customdomain/all

HTTPcURLJavaScriptPython

GET /v2/customdomain/all HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "domains": [
    {
      "id": "example.com",
      "dns_status": "active",
      "date": 1745100000000,
      "isLegacy": false,
      "app": {
        "id": "1719010867306",
        "name": "example.com",
        "online": true,
        "type": 1
      },
      "instructions": [
        {
          "type": "A",
          "name": "example.com",
          "content": "192.0.2.1"
        }
      ]
    }
  ]
}

Create custom domain

post

Creates a new custom domain and links it to an app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Body

application/json

domainNamestringRequired

Desired custom domain name

appIDstringRequired

App ID to link

Responses

200

Custom domain created successfully

application/json

anyOptional

400

Invalid domain format

application/json

401

Authentication error

application/json

403

Plan limit reached

application/json

404

App not found

application/json

409

Domain already registered or app already has a custom domain

application/json

500

External API error

application/json

post

/customdomain/create

HTTPcURLJavaScriptPython

POST /v2/customdomain/create HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "domainName": "text",
  "appID": "text"
}

{
  "status": "ok",
  "message": "Custom domain registered successfully",
  "domain": {
    "id": "example.com",
    "dns_status": "pending_check",
    "instructions": [
      {
        "type": "A",
        "name": "example.com",
        "content": "192.0.2.1"
      }
    ],
    "app": {
      "id": "1719010867306",
      "name": "1719010867306.discloud.app"
    }
  }
}