---
title: "Provisions a domain for CDN services"
method: POST
path: "/subscriptions/{subscriptionUuid}/domains/{domainName}/actions/provision"
tags: ["CDNs"]
---

# Provisions a domain for CDN services

`POST /subscriptions/{subscriptionUuid}/domains/{domainName}/actions/provision`

## Request

- Base URL: `https://api.acquia.com/v3`
- URL: `https://api.acquia.com/v3/subscriptions/{subscriptionUuid}/domains/{domainName}/actions/provision`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/docs/subscriptions/:subscriptionUuid/domains/:domainName/actions/provision/post.ts> (a function with typed inputs; its response is checked against the schema)

Provisions a domain for CDN services within a subscription by associating it with an environment. For Cloudflare-backed subscriptions, callers may provide `edge_group` (`production` or `non-production`) to select the namespace group to provision into.

## Path parameters

- `subscriptionUuid` string, required
- `domainName` string, required

## Request body

- object
  - `environment_id` string, required: The environment identifier that the domain will be associated with for purging purposes.
  - `edge_group` 'production' | 'non-production': The Edge Plus namespace group to provision the domain into for Cloudflare-backed subscriptions.

## Response `202`

Accepted - Provisioning in progress

- object
  - `_links` object, required: HAL links for the resource
    - `self` CDNAPIHalLink, required: HAL link object
      - `href` union, required: The target URI of the link (can be a URI or URI template)
        - string, uri
        - string, uri-template
      - `templated` boolean: Whether the link is a URI template
      - `type` string: Hint about the media type expected when dereferencing the target resource
      - `deprecation` string: A URL to a resource that provides deprecation information
      - `name` string: A secondary key for selecting links
      - `profile` string: A URI that hints about the profile of the target resource
      - `title` string: A human-readable identifier for the link
      - `hreflang` string: The language of the target resource
  - `_embedded` object: Embedded resources (optional)
  - `message` 'The domain provisioning has been started.', required: Confirmation message

## Other responses

- `400`: Validation Error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api.md) - [All operations](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acquia/apis/acquia-cloud-platform-api/revisions/508f8f94456d?raw)