Flowless Docs

Appearance

Create Blog Tags in Bulk​

POST
/api/v1/posts/tags/bulk

Authorizations​

SessionAuth

Session ID for authenticated requests

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

Request Body​

application/json
JSON
{
  
"names": [
  
  
"string"
  
]
}

Responses​

Tags created

Playground​

Server
Authorization
Body

Samples​

Powered by VitePress OpenAPI

Create several blog tags in one request. Existing slugs are skipped.

Auth: session + admin.

Parameters ​

None.

Request Body ​

json
{
	"names": ["release", "api"],
	"lang": "es"
}

lang is optional. When omitted, every new tag is stored as BLOG_DEFAULT_LANG.

Response 201 ​

json
{
	"data": [
		{ "id": "tag_2", "name": "release", "slug": "release" }
	],
	"user_context": { "authenticated": true, "user_type": "admin" },
	"meta": {}
}

Response Errors ​

  • 400 invalid payload
  • 401 missing session
  • 403 missing admin role
  • 429 RATE_LIMIT_EXCEEDED

Notes ​

  • Rate limit: post bucket, 10 requests / 3600s by default. A session that can publish (admin, superadmin, author, editor, or the roles in BLOG_ALLOWED_POST_ROLES and BLOG_ADMIN_ROLES) is not counted. Otherwise 429 RATE_LIMIT_EXCEEDED. See Rate limits.