Delete Repository

Delete a repository and all associated scan data

DELETE /api/repos/{id}

Delete Repository

cURL

curl --request DELETE \
  --url https://api.example.com/api/repos/{id}

200

{
  "success": true,
  "data": {
    "id": "<string>",
    "deleted": true
  },
  "error": {
    "success": true,
    "code": 123,
    "message": "<string>"
  }
}

Authentication

This endpoint requires authentication. You must be the owner of the repository to delete it.

Path Parameters

id · uuid · required

The unique identifier of the repository to delete.

Authorization

Only the user who created the repository (user_id matches the authenticated user) can delete it. Attempts to delete repositories owned by other users will result in a 403 Forbidden error.

Response

success · boolean

Indicates whether the request was successful.

data · object

Confirmation of the deletion.

Show Deletion Confirmation

id · uuid

The ID of the deleted repository.

deleted · boolean

Always true when deletion is successful.

Example Request

curl -X DELETE https://api.heimdall.example.com/api/repos/01936d2f-8c4e-7890-b123-456789abcdef \
  -H "Cookie: session=your_session_token"

Example Response

{
  "success": true,
  "data": {
    "id": "01936d2f-8c4e-7890-b123-456789abcdef",
    "deleted": true
  }
}

Error Responses

error · object

Error information when the request fails.

Show Error Object

success · boolean

Always false for error responses.

code · integer

HTTP status code.

message · string

Error message describing what went wrong.

401 Unauthorized

Returned when authentication credentials are missing or invalid.

{
  "success": false,
  "code": 401,
  "message": "Authentication required"
}

403 Forbidden

Returned when the authenticated user does not have permission to delete the repository.

{
  "success": false,
  "code": 403,
  "message": "You do not have access to this repository"
}

404 Not Found

Returned when the repository with the specified ID does not exist.

{
  "success": false,
  "code": 404,
  "message": "Repo '01936d2f-8c4e-7890-b123-456789abcdef' not found"
}

500 Internal Server Error

Returned when the server encounters an error deleting the repository.

{
  "success": false,
  "code": 500,
  "message": "Failed to delete repo: database connection error"
}

Notes

• Deleting a repository will also delete all associated scans, findings, and other related data.
• This operation is permanent and cannot be undone.
• If you’re using HTMX-based requests (with HX-Request header), the response will include an HX-Redirect header pointing to /repos.