Create a Category - Aladia API

This endpoint creates a category or subcategory.

curl --location --request POST 'https://api.aladia.io/v2/categories' \ --header 'apikey: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "Programming", "status": "active" }'

Request

Header Params

apikey

string

optional

Example:

Body Params application/json

parentId

string

optional

Only for subcategory, is the ID of the category

name

string

required

Name of Category or Subcategory

image

object (File)

optional

Image of Category or Subcategory

fileId

string

required

file ID

url

string

optional

file url

metadata

object

optional

proposedUserId

string

optional

Id of the user who proposed the category

status

string

optional

could be active or proposed

question

number

optional

number of questions

createdAt

string

optional

date

updatedAt

string

optional

date

Examples

Responses

🟢201Created

application/json

Body

string

optional

Unique Id

parentId

string

optional

Only for subcategory, is the ID of the category

name

string

optional

Name of Category or Subcategory

description

string | null

optional

category description

image

optional

Image of Category or Subcategory

Any of

File

null

fileId

string

required

file ID

url

string

optional

file url

metadata

object

optional

proposedUserId

string

optional

Id of the user who proposed the category

status

string

optional

could be active or proposed

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error