---
title: "Permanently delete a workspace and everything in it [write, owner]"
method: DELETE
path: "/universes/{slug}"
---

# Permanently delete a workspace and everything in it \[write, owner\]

`DELETE /universes/{slug}`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/universes/{slug}`
- Auth: HTTP bearer

Owner only, with a personal ast_ API key (a workspace key, a workspace-scoped token or an app credential is 403). Everyone else loses access at once; every session is stopped and its pod destroyed; agent fees held on its tasks are settled; the purchased credit in its wallet goes to the owner; apps the workspace connected are disconnected; then its sessions and transcripts, agents, artifacts, task files, files, memory, routines, channels, webhooks, keys, vaults, skills, environments, traces, members and invitations are removed. Money records (ledger, bills, receipts) are kept. A default workspace cannot be deleted (409 default_workspace), nor one with an agent live in the catalog (409 live_listing), a public environment (409 public_environment) or a published product (409 published_product). 503 pod_teardown_failed when a pod would not stop: nothing else was removed, and repeating the call finishes the delete. Read GET /universes/{slug}/deletion first to show what will go.

## Path parameters

- `slug` string, required

## Response `200`

OK

- object
  - `deleted` object, required
    - `slug` string, required
    - `sessions_stopped` integer, required: Pods that were running and were destroyed
    - `wallet_returned_micros` integer, required: Purchased credit moved from the workspace wallet to the owner, in USD micros
    - `session_ids` string[], required: Every session the workspace held, all now deleted

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/universes/:slug/delete.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)