Create Category

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/PhemiT/vaniykeempire-api/llms.txt

Use this file to discover all available pages before exploring further.

​

Request

​

Headers

​

Body Parameters

{
  "name": "Technology",
  "description": "Articles about technology and innovation"
}

​

Response

{
  "message": "Category created successfully",
  "category": {
    "_id": "507f1f77bcf86cd799439011",
    "name": "Technology",
    "slug": "technology",
    "description": "Articles about technology and innovation",
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}

​

Error Responses

​

400 - Category Already Exists

{
  "error": "Category already exists"
}

​

401 - Unauthorized

{
  "error": "No token provided"
}

​

403 - Forbidden

{
  "error": "Admin access required"
}

​

500 - Internal Server Error

{
  "error": "Database connection failed"
}

​

Example Request

curl -X POST https://api.vaniyk-empire.com/api/categories \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Technology",
    "description": "Articles about technology and innovation"
  }'

​

Notes

• The slug field is automatically generated from the name field by converting to lowercase and replacing spaces/special characters with hyphens
• Category names must be unique across the system
• The auto-generated slug must also be unique