# Delete & Deprecate System

### Delete a System with its associated versions

The System Builder can delete a system along with all its versions directly from the System Builder listing page (the page that opens when you click the **System Builder** menu).

A system can be deleted only if none of its published versions have associated users. If any user is linked to any published version, the system cannot be deleted.

When a system is deleted, all its versions, APIs, and builder credentials are permanently removed.

### Delete a Version of a System

If a specific version of a system has no associated users, the System Builder can delete that version from the Version History tab within the system editor. Deleting a version permanently removes all APIs and builder credentials linked to that version.

If the System Builder deletes the recommended version, they will be prompted to select a new recommended version, provided more than one published version exists. If only one published version remains, it will automatically become the recommended version.

If a system has no published versions, the system becomes inaccessible to users.

### Deprecate a Version of a System

If the System Builder wants to discourage the use of a specific version while there are existing users, the version can be deprecated. Deprecating a version prevents new users from selecting it while still supporting existing users. A deprecated version can be restored at any time using the “Undo Deprecate” option.

If the System Builder deprecates the recommended version, they will be prompted to select a new recommended version when more than one published version exists. If only one published version is available, it is automatically set as the recommended version.&#x20;

If no published versions exist for a system, the system cannot be accessed by new users.

When users access a deprecated version, they will see a warning message:

* If a recommended version exists, the warning prompts the user to switch to the recommended version.
* If no recommended version exists, the warning advises the user to discontinue using the system.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dckapintegrator.com/project-manager/systems-builder/delete-and-deprecate-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
