Skills

Lists configured AI skills from the ai.skills configuration. Invalid or empty configuration yields an empty list.

GET /api/ai/skills

Returns all configured skills, sorted by name.

RESPONSE Field	Value Type	Description
`name`	string	Skill name.
`description`	string	Skill description.

Example Request

# Request
GET /api/ai/skills HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
[
  {
    "name": "Summarize",
    "description": "Creates a short summary of the input."
  }
]

GET /api/ai/skills/<skillName>

Returns one skill by name token. Matching is case-insensitive and also accepts a hyphenized form. Returns 404 for an unknown skill or nested paths. Wrong methods return 405.

Example Request

# Request
GET /api/ai/skills/Summarize HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
{
  "name": "Summarize",
  "description": "Creates a short summary of the input."
}