v1beta
Double column
curl
API
CLI

Domains /

Add subdomains

Adds a new subdomain to the domain.

URL parameters

    • domain

      string required

      Name of the domain

Request attributes

  • object

    • subdomains

      array required

      An array of subdomains to add to the domain.

      • string

        A subdomain to be added.

        pattern: ^([0-9a-z]([0-9a-z\-]*[0-9a-z])?\.)*[0-9a-z]([0-9a-z\-]*[0-9a-z])?$

API
CLI

POST /v1beta/domains/{domain}/subdomains

Example request

request body

curl

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"subdomains":["site"]}' \
  https://api.northflank.com/v1beta/domains/{domain}/subdomains

Example response

200 OK

success

Example response

400 Bad Request

The subdomain is not valid (possibly because it is too long) or the domain has not been verified.

Example response

409 Conflict

The subdomain has already been added to this domain.

© 2021 Northflank Ltd. All rights reserved.

TermsPrivacy

contact@northflank.com