Categories

Last updated 8 months ago

Was this helpful?

Retrieve an overview list of all categories from your website

get

Authorizations

Query parameters

per_pageintegerOptional

Number of items to retireve, maximum of 500

Example: 20

sort_typestringOptional

Property by which to sort the results

Example: created_at

sort_orderstringOptional

Order of results (asc or desc)

Example: desc

pageintOptional

Page to retrieve number, to be used with per_page

Example: 1

Responses

get

GET /api/public/site/categories HTTP/1.1
Host: 
authorization: YOUR_API_KEY
Accept: */*

No content

Retrieve all data about an individual category

get

Authorizations

Path parameters

idstring · idRequired

The ID of the category

Example: 1234

Responses

get

GET /api/public/site/categories/{id} HTTP/1.1
Host: 
authorization: YOUR_API_KEY
Accept: */*

No content

Update a category

put

Authorizations

Path parameters

idstringRequired

The Category ID

Example: 1

Body

namestringRequired

slugstringOptional

enabledstringRequired

weightingstringOptional

meta_titlestringOptional

meta_descstringOptional

og_titlestringOptional

og_descstringOptional

og_imagestringOptional

og_typestringOptional

twitter_typestringOptional

image_altstringOptional

parentstringOptional

Responses

put

PUT /api/public/site/categories/{id} HTTP/1.1
Host: 
authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 231

{
  "name": "text",
  "slug": "text",
  "enabled": "text",
  "weighting": "text",
  "meta_title": "text",
  "meta_desc": "text",
  "og_title": "text",
  "og_desc": "text",
  "og_image": "text",
  "og_type": "text",
  "twitter_type": "text",
  "image_alt": "text",
  "parent": "text"
}

No content

Create a category

post

Authorizations

Body

namestringRequired

slugstringOptional

enabledstringRequired

weightingstringOptional

meta_titlestringOptional

meta_descstringOptional

og_titlestringOptional

og_descstringOptional

og_imagestringOptional

og_typestringOptional

twitter_typestringOptional

image_altstringOptional

parentstringOptional

Responses

post

POST /api/public/site/categories/create HTTP/1.1
Host: 
authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 231

{
  "name": "text",
  "slug": "text",
  "enabled": "text",
  "weighting": "text",
  "meta_title": "text",
  "meta_desc": "text",
  "og_title": "text",
  "og_desc": "text",
  "og_image": "text",
  "og_type": "text",
  "twitter_type": "text",
  "image_alt": "text",
  "parent": "text"
}

No content