Create subdomain
POST/api/v3/hostings/:hosting_id/subdomains
Required scopes: hosting:write
Creates a subdomain of a main hosting and returns it. When the DNS of the domain is a purchase of the same account, it also adds the A record of the subdomain. Not available (403) when the plan does not include subdomains; 409 on a subdomain, when the limit is reached or when the subdomain or its DNS record already exists
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 500
Created
Response Headers
URL of the created resource
The request is not valid: error 1000 with the errors for each field in meta.errors, error 1001 (or 1) for other invalid input
The access token is missing, invalid, expired or revoked (error 1100): request a new token and retry once
The access token is valid but not enough: missing scope (error 1101), token for the other API (error 1102), missing permission, feature not included in the plan, operation not available to sub-accounts, internal API without administrator privileges or IP address not allowed (error 1601). A new token does not change the result
The resource does not exist or does not belong to the account (error 1200)
The request conflicts with a business rule or with the current state of the resource (error 1400)
Too many requests (error 1300): retry after the seconds in the Retry-After header
Response Headers
Seconds to wait before retrying
Unexpected server error (error 1500)