list_categories
Lists categories in a ServiceNow knowledge base, enabling filtering by active status, knowledge base ID, parent category, or search query for efficient navigation.
Instructions
List categories in a knowledge base
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"ListCategoriesParams": {
"description": "Parameters for listing categories in a knowledge base.",
"properties": {
"active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by active status",
"title": "Active"
},
"knowledge_base": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by knowledge base ID",
"title": "Knowledge Base"
},
"limit": {
"default": 10,
"description": "Maximum number of categories to return",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Offset for pagination",
"title": "Offset",
"type": "integer"
},
"parent_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by parent category ID",
"title": "Parent Category"
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Search query for categories",
"title": "Query"
}
},
"title": "ListCategoriesParams",
"type": "object"
}
},
"properties": {
"params": {
"$ref": "#/$defs/ListCategoriesParams"
}
},
"required": [
"params"
],
"title": "list_categoriesArguments",
"type": "object"
}