Create DNS Zone

    • POST /api/marketplace-orders/ - Create a new DNS zone by placing an order.

      This endpoint allows you to create a new DNS zone by placing an order for a DNS offering. You can specify the domain name for the zone and provide an email address for administrative contacts. This is an asynchronous operation, and the response will include an order_uuid to track the order status.

      Notes:

      • The name attribute should be the domain name for the zone, including the trailing dot (e.g., example.com.).
      • Once the order is fulfilled, the DNS zone will be created, and you can manage its records using the DNS record management endpoints (if available) or through the WAYSCloud web interface.

      Request Example:

      POST [https://api.wayscloud.services/api/marketplace-orders/](https://api.wayscloud.services/api/marketplace-orders/)
      Authorization: Token <your_api_token>
      Content-Type: application/json

      {
        "project": "<project_uuid>",
        "offering": "<offering_uuid>",
        "plan": "<plan_uuid>",
        "attributes": {
          "name": "example.com.", // Include the trailing dot
          "email": "admin@example.com"
        }
      }

      Request Parameters:

      Parameter Description Required
      project The UUID of the project where the DNS zone will be created. Yes
      offering The UUID of the DNS offering. Yes
      plan The UUID of the plan for the offering. Yes
      attributes Yes
      attributes.name The domain name for the zone, including the trailing dot. Yes
      attributes.email Email address for administrative contacts. Yes

      Response Example:

      {
        "uuid": "order_uuid_value",
        "project": "project_uuid_value",
        "offering": "offering_uuid_value",
        "plan": "plan_uuid_value",
        "created": "2025-03-20T14:00:00Z",
        "state": "Creating",
        //... other fields...
      }

      Status Codes:

      • 201 Created: The order was successfully created.
      • 400 Bad Request: The request body contained invalid data or a required parameter was missing.
      • 401 Unauthorized: The user making the request is not authorized.
    Published