Create a service hostname set

post

https://{hostname}/delivery-manager/v1/workspaces/{workspaceName}/hostname-sets

This operation creates a new set of service hostnames for your site or app, along with the initial version. Service hostnames are fully qualified domain names (FQDN) that resolve requests from a client to the Akamai edge server and identify traffic rules. You group hostnames into sets to centrally manage shared settings, including certificates, edge hostname assignments, and TLS, for reuse across environments.

Path Params

workspaceName

string

required

Name of the workspace that unifies all resources for your application or service. You can rename the workspace with a separate operation after you initially create the resource.

Query Params

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

additionalGroupIds

array of strings

length ≥ 0

Additional groups provide a mechanism for cross-team collaboration. You can create these groups in Identity and Access Management to grant fine-grained, functional access to secondary teams. These teams can then interact with, view, or test specific components, such as individual environments or rule sets, without owning the underlying infrastructure.

additionalGroupIds

displayName

string

length ≤ 255

Name of the service hostname set visible in the Control Center application. You can change this value without affecting the hostnameSetName.

hostnameSetName

string

length ≤ 255

^[a-z][a-z0-9._-]+$

Name of the service hostname set that uniquely identifies it within a workspace.

Response

201The response shows the new service hostname set, which you can GET at the URL in the Location header.