Create Category

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

Show properties

id_categorie · integer

Unique category identifier

name · string

Category name

createdAt · string

Creation timestamp

updatedAt · string

Last update timestamp

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"
}