Skip to main content
POST
/
categories
curl -X POST https://api.marsai.com/categories \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Science Fiction"
  }'
{
  "message": "Catégorie créée avec succès",
  "categorie": {
    "id_categorie": 5,
    "name": "Science Fiction",
    "createdAt": "2026-03-07T11:30:00Z",
    "updatedAt": "2026-03-07T11:30:00Z"
  }
}
This endpoint requires ADMIN authentication.
Creates a new film category.

Body Parameters

name
string
required
Name of the category
If a category with the same name already exists, the endpoint will return a 400 error instead of creating a duplicate.

Response

message
string
Success message: “Catégorie créée avec succès”
categorie
object
The created category object
curl -X POST https://api.marsai.com/categories \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Science Fiction"
  }'
{
  "message": "Catégorie créée avec succès",
  "categorie": {
    "id_categorie": 5,
    "name": "Science Fiction",
    "createdAt": "2026-03-07T11:30:00Z",
    "updatedAt": "2026-03-07T11:30:00Z"
  }
}

Error Responses

400 Bad Request
Missing name or category already exists
{
  "error": "Le nom est obligatoire"
}
or
{
  "error": "Catégorie déjà existante"
}