...
Components of a Category
Creating a Category
Updating a Category
Deleting a Category
Get a single category
Get list of categories
Components of a Category
The category consists of the following fields
...
Code Block | ||
---|---|---|
| ||
End-point: /categories/<category id>
Request Type: DELETE
Headers:
{
"Authorization": "Bearer <your token>",
"Project": "<project domain>"
} |
Get a single Category
To get a category the following request must be made:
Code Block | ||
---|---|---|
| ||
End-point: /categories/<category id> Request Type: GET Headers: { "Authorization": "Bearer <your token>", "Project": "<project domain>" } |
Get list of Categories
To get a list categories the following request must be made:
Code Block | ||
---|---|---|
| ||
End-point: /categories
Request Type: GET
Headers:
{
"Authorization": "Bearer <your token>",
"Project": "<project domain>"
} |
The category listing endpoint supports pagination. There are additional parameters that can be used:
Parameters
limit
Description: Controls how many categories will be returned per page
Values:
Maximum value: 200
Default value: 20
Behaviour: Affects how many pages are generated.
Example: If there are 60 categories and the limit is set to 10, this will generate 6 pages of categories.Request:
Code Block language json End-point: /categories?limit=10
page
Description: Controls which categories page will be retrieved
Values:
Behaviours: Affected by the “limit“ parameter
Request
Without “limit“ parameter
Code Block End-point: /categories?page=2
With “limit“ parameter
Code Block End-point: /categories?limit=10&page=2