Delete Existing Category

Summary

Deletes an existing industry from the database.

Description

The Delete Existing Category API deletes an existing industry from the database.

Key characteristics of this endpoint:

• Private access only.
• One query parameters, no request body
• Clear separation between database errors and unexpected server failures

Endpoint

DELETE /api/category

Request

This endpoint accepts one parameter.

Parameters

Headers

This endpoint accepts a singular optional header.

Response Schema

Success - 200 OK

Example Response

[]

Error Codes & Response Types

503 Service Unavailable

Returned when the database is temporarily unavailable, a query fails due to a database issue, or Gemini is overloaded.

Response Body

{
    "detail" : "Database temporarily unavailable"
}

Typical Causes

1. MongoDB Connection Issues
2. Database timeout or query failure for a non-general reason

500 Internal Server Error

Returned when an unexpected server-side error occurs.

Response Body

{
    "detail" : "Internal server error"
}

Typical Causes

1. Unhandled runtime exception
2. Application-level failure outside database operations.

Implementation Notes

1. Logs both database-specific and unexpected errors for observability
2. Treats empty datasets as a valid state, not an error condition