CMS API
Manage categories, tags, post-tag assignments, and post revisions for Astro publishing environments.
Prefix: /api/cms
Endpoints
Categories
| Method | Path | Description | Role |
|---|---|---|---|
GET | /categories | List categories for the current environment | Editor+ |
GET | /categories/{id} | Get category details | Editor+ |
POST | /categories | Create a new category | Editor+ |
PUT | /categories/{id} | Update a category | Editor+ |
DELETE | /categories/{id} | Delete a category | Editor+ |
Tags
| Method | Path | Description | Role |
|---|---|---|---|
GET | /tags | List tags for the current environment | Editor+ |
GET | /tags/{id} | Get tag details | Editor+ |
POST | /tags | Create a new tag | Editor+ |
PUT | /tags/{id} | Update a tag | Editor+ |
DELETE | /tags/{id} | Delete a tag | Editor+ |
Post-Tag Assignments
| Method | Path | Description | Role |
|---|---|---|---|
GET | /posts/{id}/tags | List tags assigned to a post | Editor+ |
POST | /posts/{id}/tags | Assign tags to a post | Editor+ |
DELETE | /posts/{id}/tags/{tag_id} | Remove a tag from a post | Editor+ |
Post Revisions
| Method | Path | Description | Role |
|---|---|---|---|
GET | /posts/{id}/revisions | List revisions for a post | Editor+ |
GET | /revisions/{id} | Get revision details | Editor+ |