---
title: "Convert personal workspace to organization"
method: POST
path: "/api/workspaces/{workspaceId}/convert-to-organization"
tags: ["workspaces"]
---

# Convert personal workspace to organization

`POST /api/workspaces/{workspaceId}/convert-to-organization`

## Request

- Base URL: `https://rstream.io`
- URL: `https://rstream.io/api/workspaces/{workspaceId}/convert-to-organization`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, required

## Request body

- TurnWorkspaceIntoOrganizationParams
  - `name` string, required

## Response `201`

Successful response.

- TurnWorkspaceIntoOrganizationResponse
  - `id` string, required
  - `type` 'organization', required
  - `name` string, required
  - `membership` object, required
    - `role` 'owner' | 'admin' | 'member' | 'viewer', required
    - `status` 'active' | 'invited', required
    - `invitedAt` string, date-time
    - `joinedAt` string, date-time
  - `subscriptionStatus` 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'past_due' | 'paused' | 'trialing' | 'unpaid'
  - `hasPaymentMethod` boolean
  - `hasBasicTier` boolean
  - `enterprise` object
    - `status` 'active' | 'suspended' | 'disabled', required
    - `projectCreationMode` 'enterprise_projects', required
    - `workspaceKeyMode` 'disabled' | 'optional' | 'required', required

## Other responses

- `400`: Request validation failed.
- `401`: Authentication is required.
- `403`: The token is not authorized.
- `404`: Workspace not found.

---

[API](https://skmtc.dev/rstream/apis/rstream-api.md) · [All operations](https://skmtc.dev/rstream/apis/rstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rstream/apis/rstream-api/revisions/a840a2c91f22?raw)