Data Deletion

There may be cases where you want to remove data from Polyaxon, such as failed or test operations, user data for PII compliance, or an entire project.

You can delete data from Polyaxon by:

Deleting individual operations (runs);
Deleting a batch of operations;
Deleting operations matching a query filter;
Deleting a project and all its data;
Deleting an organization; or
Removing a user from an organization.

Deleting Operations

Deleting an operation removes all associated data including logs, artifacts, events, and metrics.

Single Operation

To delete a single operation, choose Delete from its actions menu in the runs table or detail view. Confirm that you want to delete the operation.

Delete an operation from the runs table.

You can also delete it from its detail view.

Confirm that you want to delete the operation.

polyaxon ops delete -p <project> -uid <run_uuid>

from polyaxon.client import RunClient

run_client = RunClient(
    owner="<owner>",
    project="<project>",
    run_uuid="<run_uuid>",
)
run_client.delete()

DELETE /api/v1/{owner}/{project}/runs/{uuid}

Batch of Operations

To delete a batch of operations, select them in the runs table and choose Delete from the Actions dropdown.

Select the operations and choose Delete from the Actions menu.

Confirm that you want to delete the selected operations.

The CLI deletes one operation at a time. To delete several known UUIDs, loop over them:

for run_uuid in "<run_uuid_1>" "<run_uuid_2>"; do
  polyaxon ops delete -p <project> --uid "$run_uuid" --yes
done

from polyaxon.client import ProjectClient

project_client = ProjectClient(owner="<owner>", project="<project>")
project_client.delete_runs(["<run_uuid_1>", "<run_uuid_2>"])

DELETE /api/v1/{owner}/{project}/runs/delete
Content-Type: application/json

{
  "uuids": ["<run_uuid_1>", "<run_uuid_2>"]
}

Delete by Query

The CLI does not expose a direct query-delete option. List matching operations, then delete each returned UUID:

polyaxon ops ls -p <project> --query "status:failed" --output json
polyaxon ops delete -p <project> --uid <matched_run_uuid> --yes

The Python client can list matching operations and delete them in batches. Fetch from offset 0 again after each deletion because the result set shrinks:

from polyaxon.client import ProjectClient

project_client = ProjectClient(owner="<owner>", project="<project>")

while True:
    runs = project_client.list_runs(
        query="status:failed",
        limit=100,
        offset=0,
    )
    if not runs:
        break
    project_client.delete_runs([run.uuid for run in runs])

The API does not provide a direct delete-by-query endpoint. Paginate through the filtered list, then send the returned UUIDs to the batch-delete endpoint:

GET /api/v1/{owner}/{project}/runs?query=status%3Afailed&limit=100&offset=0

DELETE /api/v1/{owner}/{project}/runs/delete
Content-Type: application/json

{
  "uuids": ["<matched_run_uuid_1>", "<matched_run_uuid_2>"]
}

Deleting a Project

To delete a project, navigate to the project settings and scroll to the Danger Zone section. Confirm that you want to delete your project.

Choose Delete from the project's Danger Zone.

Confirm that you want to delete the project.

polyaxon project delete -p <project>

from polyaxon.client import ProjectClient

project_client = ProjectClient(owner="<owner>", project="<project>")
project_client.delete()

DELETE /api/v1/{owner}/{project}

Deleting a project is irreversible. All operations, artifacts, and associated data will be permanently removed. If you may need the project later, archive it instead. Archiving removes it from the active projects list without deleting its data.

Deleting an Organization

To delete an organization, navigate to the organization settings and scroll to the Danger Zone section. All projects must be deleted before the organization can be removed. The organization and all associated data will be permanently deleted.

Choose Delete from the organization's Danger Zone.

Confirm that you want to delete the organization.

from polyaxon.client import PolyaxonClient

client = PolyaxonClient()
client.organizations_v1.delete_organization("<owner>")

DELETE /api/v1/orgs/{owner}

Removing an Organization Member

Removing a user from an organization is available through the UI, Python client, and API:

Organization owners can remove users from the organization members settings.

Choose Remove Member from the member's Actions menu.

Confirm that you want to remove the member.

from polyaxon.client import OrganizationClient

organization_client = OrganizationClient(owner="<organization>")
organization_client.delete_member("<username>")

DELETE /api/v1/orgs/{owner}/members/{name}

Removing organization membership does not delete the user's global account.

On this page