Create Category

Production

https://api.msaaq.com/v1

POST

/v1/admin/communities/{community}/categories

Last modified:2026-03-01 10:26:45

Creates a new category under the specified community. Slug is auto-generated from name if not provided. Increments community's categories_count.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Example

{
    "name": "نقاشات عامة",
    "description": "تصنيف للنقاشات العامة"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.msaaq.com/v1/v1/admin/communities/1/categories' \
--header 'X-Academy-ID: {{academy_id}}' \
--header 'Accept: application/json' \
--header 'Accept-Language: ar' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "نقاشات عامة",
    "description": "تصنيف للنقاشات العامة"
}'

Responses

🟢201Created

application/json

Category created successfully

Body

Example

{
    "message": "تم الحفظ بنجاح",
    "data": {
        "id": 1,
        "community_id": 1,
        "name": "عام",
        "description": "نقاشات عامة",
        "slug": "general",
        "sort": 0,
        "topics_count": 30,
        "created_at": "2026-02-26 11:30:00",
        "updated_at": "2026-02-26 11:30:00"
    }
}

🟠422Unprocessable Entity

Modified at 2026-03-01 10:26:45

List Categories

Show Category