AI Agent Topic Category

18 Sep 2025
2 Minutes to read

Print
Share
Dark
Light

AI Agent Topic Category

Updated on 18 Sep 2025
2 Minutes to read

Print
Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback!

AI Agent Topic Category

Categories - Categories Manage
- GET aiagent/topiccategories - Get the list of Categories
- GET aiagent/topiccategories/{id} - Get a single Topic Category
- POST aiagent/topiccategories - Create a new topic Category
- PUT aiagent/topiccategories/{id} - Update the topic Category
- DELETE aiagent/topiccategories/{id} - Remove the topic Category

AI Agent Topic Category JSON Format

AI Agent Topic Category is represented as simple flat JSON objects with the following keys:

Name	Type	Description
`id`	guid	Id of the category.
`aiAgentId`	guid	Id of the AI Agent.
`name`	string	Name of the category.
`order`	integer	Must be greater than or equal to 0, ascending order.
`parentId`	guid	Parent Id of the category.

Get the list of Categories

GET aiagent/topiccategories

Parameters:

Name	Type	in	Required	Description
`aiAgentId`	guid	query	no	Id of the AI Agent.
`parentId`	guid	query	no	Parent Id of the category.

Response:

An array of AI Agent Topic Category

Example

Sample Request:

curl https://api11.comm100.io/v4/aiagent/topiccategories \ 
    -X 'GET' \ 
    -H 'Authorization: Bearer {access_token}' \

Response:

HTTP/1.1 200 OK

[
  {
      "id": "ee705b05-33c0-43b6-ab4a-a138f28b6aa2",
      "aiAgentId": "e8bf0d25-eed6-4a46-a417-318e15019609",
      "name": "fruit",
      "order": 1,
      "parentId": "3bfcf193-9939-4abd-a832-2625ea02e75b"
  }
]

Get a single Topic Category

GET aiagent/topiccategories/{id}

Parameters:

No Parameters

Response:

AI Agent Topic Category

Example

Sample Request:

curl https://api11.comm100.io/v4/aiagent/topiccategories/ee705b05-33c0-43b6-ab4a-a138f28b6aa2 \ 
    -X 'GET' \ 
    -H 'Authorization: Bearer {access_token}' \

Response:

HTTP/1.1 200 OK

{
  "id": "ee705b05-33c0-43b6-ab4a-a138f28b6aa2",
  "aiAgentId": "e8bf0d25-eed6-4a46-a417-318e15019609",
  "name": "fruit",
  "order": 1,
  "parentId": "3bfcf193-9939-4abd-a832-2625ea02e75b"
}

Create a new Topic Category

POST aiagent/topiccategories

Parameters:

Name	Type	in	Required	Description
`aiAgentId`	guid	body	yes	Id of the AI Agent.
`name`	string	body	yes	Name of the category.
`order`	integer	body	no	Must be greater than or equal to 0, ascending order.
`parentId`	guid	body	no	Parent Id of the category.

Response:

AI Agent Topic Category

Example

Sample Request:

curl https://api11.comm100.io/v4/aiagent/topiccategories \ 
    -X 'POST' \ 
    -H 'Authorization: Bearer {access_token}' \ 
    -H 'Content-Type: application/json' \ 
    -D '{"aiAgentId":"e8bf0d25-eed6-4a46-a417-318e15019609","name":"fruit","order":1,"parentId":"3bfcf193-9939-4abd-a832-2625ea02e75b"}'

Response:

HTTP/1.1 201 Created

{
  "id": "ee705b05-33c0-43b6-ab4a-a138f28b6aa2",
  "aiAgentId": "e8bf0d25-eed6-4a46-a417-318e15019609",
  "name": "fruit",
  "order": 1,
  "parentId": "3bfcf193-9939-4abd-a832-2625ea02e75b"
}

Update the Topic Category

PUT aiagent/topiccategories/{id}

Parameters:

Name	Type	in	Required	Description
`Id`	guid	body	yes	Id of the AI Agent Topic Category.
`aiAgentId`	guid	body	yes	Id of the AI Agent.
`name`	string	body	yes	Name of the category.
`order`	integer	body	no	Must be greater than or equal to 0, ascending order.
`parentId`	guid	body	yes	Parent Id of the category.

Response:

AI Agent Topic Category

Example

Sample Request:

curl https://api11.comm100.io/v4/aiagent/topiccategories/ee705b05-33c0-43b6-ab4a-a138f28b6aa2 \ 
    -X 'PUT' \ 
    -H 'Authorization: Bearer {access_token}' \ 
    -H 'Content-Type: application/json' \ 
    -D '{"id":"ee705b05-33c0-43b6-ab4a-a138f28b6aa2","aiAgentId":"e8bf0d25-eed6-4a46-a417-318e15019609","name":"fruit","order":1,"parentId":"3bfcf193-9939-4abd-a832-2625ea02e75b"}'

Response:

HTTP/1.1 200 OK

{
  "id": "ee705b05-33c0-43b6-ab4a-a138f28b6aa2",
  "aiAgentId": "e8bf0d25-eed6-4a46-a417-318e15019609",
  "name": "fruit",
  "order": 1,
  "parentId": "3bfcf193-9939-4abd-a832-2625ea02e75b"
}

Remove the topic Category

DELETE aiagent/topiccategories/{id}

Parameters:

No Parameters

Response:

No Content

Example

Sample Request:

curl https://api11.comm100.io/v4/aiagent/topiccategories/ee705b05-33c0-43b6-ab4a-a138f28b6aa2 \ 
    -X 'DELETE' \ 
    -H 'Authorization: Bearer {access_token}' \

Response:

HTTP/1.1 204 No Content

Was this article helpful?

What's Next

AI Agent Topic

Table of contents