> ## Documentation Index > Fetch the complete documentation index at: https://supermemory.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Delete namespace > Retire a namespace by permanently deleting its content, or preserve that knowledge by moving everything into another namespace first. Moves are queued and complete asynchronously. ## OpenAPI ````yaml https://api.supermemory.ai/v5/openapi delete /ns/{namespace} openapi: 3.1.0 info: title: supermemory API description: >- The Memory API for the AI era. OpenAPI operations include x-codeSamples for the official TypeScript and Python SDKs (Mintlify-compatible). version: 5.0.0 servers: - description: Production Server url: https://api.supermemory.ai security: - bearerAuth: [] tags: - name: Ingest description: Ingest documents, files, URLs, conversations, and other content - name: Recall (Search) description: >- Semantic recall across your content — supports memories, hybrid, and documents modes - name: Profiles description: Maintained static, dynamic, and custom-bucket profiles scoped by namespace - name: Content Management description: List, get, update, and delete content and memories - name: Namespaces description: List and manage isolated namespaces and their settings - name: Connectors description: >- Sync external sources such as Google Drive, Notion and GitHub into a namespace - name: Organization description: Read and update organization-wide settings paths: /ns/{namespace}: delete: tags: - Namespaces summary: Delete namespace description: >- Retire a namespace by permanently deleting its content, or preserve that knowledge by moving everything into another namespace first. Moves are queued and complete asynchronously. operationId: deleteNsByNamespace parameters: - in: path name: namespace schema: type: string maxLength: 100 pattern: ^[a-zA-Z0-9_:-]+$ example: user_alex required: true description: >- Namespace identifier. This can be an ID for your user, a project ID, or any other identifier you wish to use to scope documents and memories. - in: query name: moveTo schema: example: project_archive type: string maxLength: 100 pattern: ^[a-zA-Z0-9_:-]+$ description: >- Destination namespace that should receive this namespace's content before deletion. Omit to permanently delete the content. responses: '200': content: application/json: schema: oneOf: - type: object properties: status: type: string const: deleted description: The namespace and its content are gone namespace: type: string description: Deleted namespace identifier deletedDocumentsCount: type: integer minimum: 0 maximum: 9007199254740991 description: Number of documents permanently removed deletedMemoriesCount: type: integer minimum: 0 maximum: 9007199254740991 description: Number of memories permanently removed required: - status - namespace - deletedDocumentsCount - deletedMemoriesCount - type: object properties: status: type: string const: queued description: The move continues asynchronously after this response operationId: type: string description: >- Identifier used to trace the asynchronous move operation namespace: type: string description: Source namespace being removed moveTo: type: string description: Destination namespace receiving the content required: - status - operationId - namespace - moveTo description: >- Namespace permanently deleted (status "deleted"). A move answers 202 with status "queued". '202': content: application/json: schema: type: object properties: status: type: string const: queued description: The move continues asynchronously after this response operationId: type: string description: Identifier used to trace the asynchronous move operation namespace: type: string description: Source namespace being removed moveTo: type: string description: Destination namespace receiving the content required: - status - operationId - namespace - moveTo description: Namespace move queued '400': description: Invalid move destination content: application/json: schema: oneOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/ValidationErrorResponse' '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Write access required '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Namespace not found '409': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Namespace is busy '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error x-codeSamples: - lang: typescript label: TypeScript SDK source: >- import { Supermemory } from "supermemory"; const client = new Supermemory(); // reads SUPERMEMORY_API_KEY // Move everything into another namespace instead of deleting: add { moveTo: "project_main" } const res = await client.namespaces.delete("project_old"); console.log(res.status); // "deleted", or "queued" when moving - lang: python label: Python SDK source: >- from supermemory import Supermemory client = Supermemory() # reads SUPERMEMORY_API_KEY # Move everything into another namespace instead of deleting: add move_to="project_main" res = client.namespaces.delete("project_old") print(res.status) # "deleted", or "queued" when moving - lang: bash label: cURL source: >- curl -X DELETE "https://api.supermemory.ai/ns/project_old?moveTo=project_main" \ -H "Authorization: Bearer $SUPERMEMORY_API_KEY" components: schemas: ErrorResponse: type: object properties: error: type: string description: Error message example: Invalid request parameters details: type: string description: Additional error details example: Query must be at least 1 character long required: - error ValidationErrorResponse: type: object description: Body returned when request input fails schema validation properties: success: type: boolean enum: - false error: type: array description: Validation issues items: type: object properties: message: type: string path: type: array items: oneOf: - type: string - type: number required: - message data: description: The input that failed validation required: - success - error securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.