Skip to content

Create Blog Tag

POST
/api/v1/posts/tags

Authorizations

SessionAuth

Session ID for authenticated requests

Type
API Key (header: X-Session-ID)

Request Body

application/json
JSON
{
  
"name": "string",
  
"slug": "string"
}

Responses

Tag created

Playground

Server
Authorization
Body

Samples

Powered by VitePress OpenAPI

Create a blog tag.

Auth: session + admin.

Parameters

None.

Request Body

json
{
	"name": "Product",
	"slug": "product"
}

Response 200

json
{
	"data": { "id": "tag_2", "name": "Product", "slug": "product" },
	"user_context": { "authenticated": true, "user_type": "admin" },
	"meta": {}
}

Response Errors

  • 400 invalid tag payload
  • 401 missing session
  • 403 missing admin role

Notes

  • Use this for editorial tags and classification.
  • Keep tag slugs short and stable.