Create a workspace

post

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

This operation creates a workspace. A workspace stores all configurations for your service, such as environments, origins, hostnames, and rules, keeping them separate from other workspaces in your account.

You use workspaces to:

Manage all software development phases of your service as distinct environments.
Manage content delivery for a collection of hostnames that share similar settings.
Define ownership boundaries to support easy team collaboration.
Unify all resources pertaining to your application or service.

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

contractId

string

required

Write-once Unique identifier for the contract, linking to billing or licensing agreements.

createdBy

string

User identifier for the person who created the workspace.

createdTime

date-time

A string representing an ISO 8601 timestamp.

defaultGroupId

string

required

^[0-9]+$

A unique identifier for a group that controls access to workspace components. You configure groups in Identity and Access Management.

description

string

length ≤ 255

Additional description for the workspace.

displayName

string

length ≤ 500

Name of the workspace visible in the Control Center application. You can change this value without affecting the workspaceName.
If no workspaceName is provided one will be created from displayName.

modifiedBy

string

User identifier for the person who last modified the workspace.

modifiedTime

date-time

A string representing an ISO 8601 timestamp.

productId

string

required

Write-once Unique identifier for each Akamai product.

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

400Bad request.

401Unauthorized.

403Forbidden.

404Not found.

405Method not allowed.

413Request entity too large.

415Unsupported media type.

429Too many requests.

500Internal server error.