Create Workspace | Astronomer Documentation

curl -X POST https://api.astronomer.io/platform/v1beta1/organizations/organizationId/workspaces \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "My Workspace"
}'

{
  "cicdEnforcedDefault": true,
  "createdAt": "2023-09-08T12:00:00Z",
  "id": "clm8t5u4q000008jq4qoc3036",
  "name": "My Workspace",
  "organizationId": "clm8t5u4q000008jq4qoc3036",
  "updatedAt": "2023-09-08T13:30:00Z",
  "createdBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  },
  "description": "This is a test workspace",
  "organizationName": "My Organization",
  "updatedBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  }
}

Create a Workspace.

curl -X POST https://api.astronomer.io/platform/v1beta1/organizations/organizationId/workspaces \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "My Workspace"
}'

{
  "cicdEnforcedDefault": true,
  "createdAt": "2023-09-08T12:00:00Z",
  "id": "clm8t5u4q000008jq4qoc3036",
  "name": "My Workspace",
  "organizationId": "clm8t5u4q000008jq4qoc3036",
  "updatedAt": "2023-09-08T13:30:00Z",
  "createdBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  },
  "description": "This is a test workspace",
  "organizationName": "My Organization",
  "updatedBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  }
}

Create a Workspace.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organizationIdstringRequired

The ID of the Organization to which the Workspace will belong.

Request

The request body for creating a new Workspace.

namestringRequired<=50 characters

The Workspace's name.

cicdEnforcedDefaultbooleanOptional

Whether new Deployments enforce CI/CD deploys by default.

descriptionstringOptional

The Workspace's description.

Response

cicdEnforcedDefaultboolean

Whether CI/CD deploys are enforced by default.

createdAtstringformat: "date-time"

The time when the Workspace was created in UTC, formatted as YYYY-MM-DDTHH:MM:SSZ

idstring

The Workspace's ID.

namestring

The Workspace's name.

organizationIdstring

The ID of the organization to which the workspace belongs.

updatedAtstringformat: "date-time"

The time when the Workspace was updated in UTC, formatted as YYYY-MM-DDTHH:MM:SSZ

createdByobject

descriptionstring

The Workspace's description.

organizationNamestring

The name of the Organization to which the Workspace belongs.

updatedByobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.astronomer.io/platform/v1beta1/organizations/organizationId/workspaces \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "My Workspace"
>	}'

1	{
2	"cicdEnforcedDefault": true,
3	"createdAt": "2023-09-08T12:00:00Z",
4	"id": "clm8t5u4q000008jq4qoc3036",
5	"name": "My Workspace",
6	"organizationId": "clm8t5u4q000008jq4qoc3036",
7	"updatedAt": "2023-09-08T13:30:00Z",
8	"createdBy": {
9	"id": "clm8qv74h000008mlf08scq7k",
10	"apiTokenName": "my-token",
11	"avatarUrl": "https://avatar.url",
12	"fullName": "Jane Doe",
13	"subjectType": "USER",
14	"username": "user1@company.com"
15	},
16	"description": "This is a test workspace",
17	"organizationName": "My Organization",
18	"updatedBy": {
19	"id": "clm8qv74h000008mlf08scq7k",
20	"apiTokenName": "my-token",
21	"avatarUrl": "https://avatar.url",
22	"fullName": "Jane Doe",
23	"subjectType": "USER",
24	"username": "user1@company.com"
25	}
26	}