Skip to main content

​
Summary

A project can disappear from your project list because it was deleted or because your access changed. Project deletion is available through the Braintrust UI, CLI, and API. Deleted projects cannot be restored through the Braintrust UI, CLI, or API. Braintrust support can check whether recovery is possible, but restoration is not guaranteed.

​
Check whether the project was deleted

  1. Confirm that you are viewing the correct organization.
  2. Ask an organization owner to verify that you still have access to the project.
  3. If your organization has audit logging, search for a project.deleted event. The event identifies who or which API key initiated the deletion.
  4. Review recent scripts, CI jobs, Terraform changes, or other automation that can call the project deletion API or CLI command.
If automation deleted the project, pause or update it before restoring the project. Otherwise, the next run can delete the project again.

​
Request a project restoration

Contact Braintrust support and include:
  • Organization name or ID.
  • Project name and ID, if known.
  • Other affected project names and IDs, if multiple projects disappeared.
  • Approximate deletion time.
  • Relevant project.deleted audit log entry, if available.
  • Any recent UI, CLI, API, or infrastructure-as-code changes that may have deleted the project.
If recovery is possible, Braintrust support can restore the project. After restoration, verify that the project and its data are accessible before resuming automation.

​
Prevent accidental project deletion

  • Limit Delete permission to members and service accounts that need it. For Enterprise organizations, use custom permission groups to scope access to specific projects.
  • Use service accounts with least-privilege, project-scoped permissions for scripts, CI jobs, and infrastructure automation. Personal API keys inherit the permissions of the user who created them.

​
References