Skip to main content
Permanently delete a project and all its associated resources. This operation cannot be undone.

​
Path Parameters

​
id
string
required
Project identifier to delete. Must be a valid project UUID.Example: 3f4a5b6c-7d8e-9f0a-1b2c-3d4e5f6a7b8c

​
Response

Returns an empty response with HTTP 200 status code on successful deletion. 
curl -X DELETE 'https://api.frontier.example.com/v1beta1/projects/3f4a5b6c-7d8e-9f0a-1b2c-3d4e5f6a7b8c' \
  -H 'Authorization: Bearer <token>'

​
Response Example

{}
Successful deletion returns an empty JSON object.

​
Error Responses

​
code
string
Error code indicating the type of error.
​
message
string
Human-readable error message.

​
Common Errors

  • 401 Unauthorized: Invalid or missing authentication token
  • 403 Forbidden: You don’t have permission to delete this project
  • 404 Not Found: Project not found
  • 500 Internal Server Error: Server encountered an unexpected error during deletion

​
Notes

  • This operation is irreversible - deleted projects cannot be recovered
  • Deleting a project will:
    • Remove all project resources and relations
    • Delete all policies associated with the project
    • Remove all user and group memberships
    • Clean up all associated metadata
  • You must have delete/admin permissions on the project to perform this operation
  • The delete operation uses a cascade deleter service that handles cleanup of all related resources
  • Consider disabling the project instead of deleting it if you need to preserve historical data
  • An audit log entry may be created for the deletion event (depending on configuration)

Build docs developers (and LLMs) love

Get started for freeTalk to us