Create a workspace

POST

/v1/organization/workspaces

const workspace = await bird.organization.workspaces.create({
  name: "Staging",
});
console.log(workspace.id);

workspace = client.organization.workspaces.create(name="Staging")
print(workspace.id)

workspace, err := client.Organization.Workspaces.Create(context.Background(), bird.OrganizationWorkspacesCreateParams{Name: "Staging"})
if err != nil {
	log.Fatal(err)
}
fmt.Println(workspace.Id)

$workspace = $bird->organization->workspaces->create((new WorkspaceCreate())->setName('Staging'));
echo $workspace->getId() . PHP_EOL;

bird organization workspaces create Production

curl -X POST "https://us1.platform.bird.com/v1/organization/workspaces" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production"
  }'

响应201

{
  "id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
  "organization_id": "org_01krdgeqcxet5s7t44vh8rt9mg",
  "name": "Production",
  "notification_emails": {
    "operational": [
      "alerts@example.com"
    ]
  },
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}

Creates a workspace in the caller's organization. The caller needs organization workspace write access, which organization master keys and signed-in organization owners and administrators have, as do CLI or MCP access tokens they authorize with that access. Workspace API keys cannot create workspaces. The organization's workspace limit counts every workspace it holds, including workspaces awaiting permanent deletion, and a request beyond the limit fails with E10014.

请求载荷

name

string

必填

Must include at least one letter or number.

响应载荷

id

string

必填

organization_id

string

必填

name

string

必填

notification_emails

object

必填

显示子属性

logo_url

nullable string

HTTPS URL to the current workspace logo. null when unset.

created_at

string

必填

updated_at

string

必填

继续查看此主题的文档、指南和示例。

获取实施简报

const workspace = await bird.organization.workspaces.create({
  name: "Staging",
});
console.log(workspace.id);

workspace = client.organization.workspaces.create(name="Staging")
print(workspace.id)

workspace, err := client.Organization.Workspaces.Create(context.Background(), bird.OrganizationWorkspacesCreateParams{Name: "Staging"})
if err != nil {
	log.Fatal(err)
}
fmt.Println(workspace.Id)

$workspace = $bird->organization->workspaces->create((new WorkspaceCreate())->setName('Staging'));
echo $workspace->getId() . PHP_EOL;

bird organization workspaces create Production

curl -X POST "https://us1.platform.bird.com/v1/organization/workspaces" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production"
  }'

响应201

{
  "id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
  "organization_id": "org_01krdgeqcxet5s7t44vh8rt9mg",
  "name": "Production",
  "notification_emails": {
    "operational": [
      "alerts@example.com"
    ]
  },
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}

Create a workspace

请求载荷

响应载荷

相关资源