Organization -- Workspaces

Create Workspace

The endpoint allows you to create a new Workspace within an Organization.

A Workspace is a collaborative environment within an Organization that groups Projects together. It facilitates team collaboration, resource management, and organization of data operations.

The hierarchical structure in Peaka is:

<code>Organization (top-level) → Workspace → Project</code>

Projects contain data catalogs and workflows that teams manage within a Workspace.

post/organizations/{organizationId}/workspaces

Request

  • Base URL: https://partner.peaka.studio/api/v1
  • URL: https://partner.peaka.studio/api/v1/organizations/{organizationId}/workspaces
  • Auth: HTTP bearer

Path parameters

organizationIdstring required

Organization ID

Request body

namestring

The name of the workspace

descriptionstring

Descriptive text about the workspace

Response

Successful operation

idstring uuid

The unique identifier of the workspace

namestring

The name of the workspace

createdBystring uuid

The unique identifier of the user who created the workspace

organizationIdstring uuid

The unique identifier of the organization to which the workspace belongs

descriptionstring

Descriptive text about the workspace

createdAtstring

The date and time the workspace was created

defaultWorkspaceboolean

Whether the workspace is the default workspace for the organization.

This is a backward compatibility field in order to create projects in the default workspace if the workspace is not specified.

Changes

No recorded changes to this operation across all 1 revision of this API.