Skip to main content
POST
/
org
/
{org}
/
domain
Create a domain
curl --request POST \
  --url https://api.cpln.io/org/{org}/domain \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "tags": {},
  "name": "<string>",
  "spec": {
    "dnsMode": "cname",
    "gvcLink": "<string>",
    "certChallengeType": "http01",
    "workloadLink": "<string>",
    "acceptAllHosts": true,
    "acceptAllSubdomains": true,
    "ports": [
      {
        "number": 123,
        "protocol": "http2",
        "routes": [
          {
            "replacePrefix": "<string>",
            "regex": "<string>",
            "prefix": "<string>",
            "workloadLink": "<string>",
            "port": 123,
            "hostPrefix": "<string>",
            "hostRegex": "<string>",
            "headers": {
              "request": {
                "set": {}
              }
            },
            "replica": 123,
            "mirror": [
              {
                "workloadLink": "<string>",
                "port": 123,
                "percent": 123
              }
            ]
          }
        ],
        "cors": {
          "allowOrigins": [
            {
              "exact": "<string>",
              "regex": "<string>"
            }
          ],
          "allowMethods": [
            "<string>"
          ],
          "allowHeaders": [
            "<string>"
          ],
          "exposeHeaders": [
            "<string>"
          ],
          "maxAge": "<string>",
          "allowCredentials": true
        },
        "tls": {
          "minProtocolVersion": "TLSV1_2",
          "cipherSuites": [
            [
              "ECDHE-ECDSA-AES256-GCM-SHA384",
              "ECDHE-ECDSA-CHACHA20-POLY1305",
              "ECDHE-ECDSA-AES128-GCM-SHA256",
              "ECDHE-RSA-AES256-GCM-SHA384",
              "ECDHE-RSA-CHACHA20-POLY1305",
              "ECDHE-RSA-AES128-GCM-SHA256",
              "AES256-GCM-SHA384",
              "AES128-GCM-SHA256"
            ]
          ],
          "clientCertificate": {
            "secretLink": "<string>"
          },
          "serverCertificate": {
            "secretLink": "<string>"
          }
        }
      }
    ]
  }
}
'
{
  "status": 123,
  "message": "<string>",
  "code": "<string>",
  "details": {},
  "id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.controlplane.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Service account key can be used as API keys

Path Parameters

org
string
required

Body

application/json
description
string
Maximum string length: 250
tags
object
name
string
Maximum string length: 253
spec
object

Response

Domain was created successfully