Skip to main content
POST
Create category
Octavia AI CMS allows you to create multilingual categories to organize your content effectively.
Each category can include names and descriptions in multiple languages using the standard multilingual format.
Example:

Rules

  • ✅ Keys must be lowercase ISO 639-1 codes (e.g., en, es, fr)
  • ✅ At least one language (your default locale) is required
  • ✅ Values must be plain strings
  • ❌ Do not send a single string for multilingual fields
  • ❌ Do not use uppercase or invalid codes (e.g., EN, eng)

Validation & Behavior

  • Slug must be unique within your workspace
  • Name and description fields support multilingual format
  • Thumbnail and isPrivate fields are optional
  • Language fallback applies when fetching data (if a requested language doesn’t exist, the default is returned)

Authorizations

x-api-key
string
header
required

Body

application/json
name
object
required

Category name in multiple languages

slug
string
required

URL-friendly unique identifier

thumbnail
string<uri>

Optional thumbnail URL

description
object

Optional description in multiple languages

isPrivate
boolean

If true, hides the category from public listings

Example:

false

isActive
boolean

Whether category is active

Response

Created

success
boolean
required
statusCode
integer
required
message
string
required
data
object
required