1. Workspace
Cognita
  • Introduction
  • Auth
    • register
      POST
    • login
      POST
    • callback
      GET
    • profile
      GET
    • verify email
      POST
    • refresh
      POST
    • logout
      POST
    • forgot password
      POST
    • reset password
      POST
    • request reset password
      POST
    • update-profile
      PATCH
  • Meetings
    • Transcripts
      • Retrieve transcripts for a meeting
    • upload init
    • Get meeting details
  • Transcription
    • live
    • Get Transcript segments
    • Create translation for transcript
  • Organization
    • Billing
      • Get Billing Details
      • Update Plan
    • Org
      • Create Organization
      • Get Organization
      • Get Organizations
      • update organization
      • update settings
      • Delete Organization
      • get organization settings
      • Suspend
      • Resume
    • Retention
      • Set Retention Policy
      • Get Retention Policy
      • Update Retention Policy
    • Domains
      • Allowed Domains
      • Allowed Domains
      • Domain verfying
  • Workspaces
    • Org
      • Get Organization Workspaces
    • Workspace
      • Create Workspace
        POST
      • Get Workspace
        GET
      • Update Workspace
        PUT
      • Delete Workspace
        DELETE
    • Users
      • Get Workspace Members
      • Delete Member from Workspace
    • Meetings
      • Start a meeting in workspace
  • configurations
    • feature-flags
    • configs
    • tenant-defaults
  • Schemas
    • Organization
      • OrganizationSettings
      • FeatureFlags
      • RetentionPolicy
      • Organization
      • CreateOrgRequestBody
    • Billing & Subscriptions
      • BillingAccount
      • SubscriptionEntitlements
      • SubscriptionPlan
      • Subscription
      • PaymentMethod
      • Invoice
      • UsageRecords
      • Bill
    • Roles & permissions
      • Permissions
    • Workspace
      • Workspaces
    • Meeting & Recordings
      • Meetings
    • Trascriptions & Summaries
    • Integrations
    • Notifications & Audit logs
    • AI Services
    • Localization
    • Auth & Users
      • user
      • AccessToken
    • ErrorResponse
    • SuccessResponse
    • DeviceInfo
    • Session
  1. Workspace

Delete Workspace

Developing
Develop Env
http://localhost:3000/api
Develop Env
http://localhost:3000/api
DELETE
http://localhost:3000/api
/workspaces/{workspace_id}
Maintainer:Suhaib Ghattass

Purpose
Permanently delete a workspace and all its contents (meetings, files, notes). Requires confirmation and respects retention/legal holds.

Auth / Scope
Only workspace owner or org owner can delete. Cannot delete if active legal hold exists.

Headers
Authorization: Bearer <USER_JWT>
Idempotency & retries
Safe to retry — returns 204 if already deleted.

Rate limits
5 deletes/hour per user.

Request

Path Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'http://localhost:3000/api/workspaces/'
Response Response Example
{}
Modified at 2025-10-22 21:43:03
Previous
Update Workspace
Next
Get Workspace Members
Built with