Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

Delete a workspace

Delete an existing workspace. Deletion is asynchronous: the workspace transitions to the Terminating state and its contexts are deleted, after which the workspace itself is removed.

DELETE /workspaces/{workspace_name}

  • X-Pinecone-Api-Version (header, string, required) — Required date-based version header
  • workspace_name (path, string, required) — The name of the workspace to delete.
  • 202 — The request to delete the workspace has been accepted.
  • 401 — Unauthorized. Possible causes: Invalid API key.
  • 403 — Forbidden. The API key does not have permission to perform this action, or a project limit (such as the maximum number of workspaces) has been reached.
  • 404 — Workspace not found.
  • 500 — Internal server error.
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu