Blog category management
6 endpoints.
| Method | Path | Summary |
|---|---|---|
GET | /api/blog-categories | List blog categories |
POST | /api/blog-categories | Create a category (blogs:manage | blogs:create — the web's «إدارة التصنيفات» set) |
DELETE | /api/blog-categories/{id} | Delete a category (blogs:manage | blogs:create) |
GET | /api/blog-categories/{id} | One blog category (same read rule as the list) |
PUT | /api/blog-categories/{id} | Rename a category (blogs:manage | blogs:create) |
GET | /api/blog-categories/blog/{blogId} | A post's categories (same read rule as the list) |
GET /api/blog-categoriesReadable exactly where the community's blogs are (member, or guest preview), otherwise 404. Post counts only count posts the caller may see. Auth: optional — a token changes what you can see (see "Who may read what").
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
communityId | query | no | string (uuid) | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | success, data: [BlogCategory] | — |
404 | The caller may not read this community's blogs | — |
POST /api/blog-categoriesAuth: Bearer JWT required.
Request body (required) — application/json
| Field | Type | Required | Description |
|---|---|---|---|
communityId | string (uuid) | no | — |
name | string | yes | — |
description | string | no | — |
Responses
| Status | Description | Body |
|---|---|---|
201 | success, data: BlogCategory | — |
DELETE /api/blog-categories/{id}Auth: Bearer JWT required.
Responses
| Status | Description | Body |
|---|---|---|
200 | success | — |
GET /api/blog-categories/{id}Auth: optional — a token changes what you can see (see "Who may read what").
Responses
| Status | Description | Body |
|---|---|---|
200 | success, data: BlogCategory | — |
PUT /api/blog-categories/{id}Auth: Bearer JWT required.
Responses
| Status | Description | Body |
|---|---|---|
200 | success, data: BlogCategory | — |
GET /api/blog-categories/blog/{blogId}Auth: optional — a token changes what you can see (see "Who may read what").
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
blogId | path | yes | string (uuid) | — |
Responses
| Status | Description | Body |
|---|---|---|
200 | success, data: [BlogCategory] | — |