Create Topic (Tenant)

Production

https://api.msaaq.com/v1

POST

/tenant/communities/{community}/topics

Last modified:2026-03-03 02:57:35

Creates a new topic. Author is the authenticated member. Supports image and attachment uploads.

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 multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.msaaq.com/v1/tenant/communities/mjtma-alakadymyh/topics' \
--header 'X-Tenant: academy.msaaq.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--form 'title="موضوع جديد"' \
--form 'body="محتوى الموضوع..."' \
--form 'community_category_id=""' \
--form 'images[]=""' \
--form 'attachments[]=""'

Responses

🟢201Created

application/json

Topic created successfully

Body

Example

{
    "message": "تم الحفظ بنجاح",
    "data": {
        "id": 1,
        "title": "موضوع جديد",
        "body": "محتوى الموضوع...",
        "status": "published",
        "is_pinned": false,
        "is_locked": false,
        "posts_count": 12,
        "likes_count": 5,
        "author": {
            "id": 1,
            "name": "أحمد محمد",
            "avatar": "https://example.com/avatar.jpg"
        },
        "category": {
            "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"
        },
        "liked": false,
        "images": [
            "http://example.com"
        ],
        "attachments": [
            {
                "name": "string",
                "url": "http://example.com",
                "size": 0
            }
        ],
        "created_at": "2026-02-26 11:30:00",
        "updated_at": "2026-02-26 11:30:00"
    }
}

🟠403Forbidden

🟠404Not Found

🟠422Unprocessable Entity

Modified at 2026-03-03 02:57:35

List Topics (Tenant)

Show Topic (Tenant)