Lists configured AI providers and returns details for one provider. Provider path tokens use the display name rules described on the AI Web API overview.

Returns all configured providers as a JSON array.

# Request
GET /api/ai/providers HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
[
  {
    "providerId": "Primary Provider",
    "displayName": "Primary Provider",
    "providerType": "openai",
    "providerTypeDisplayName": "OpenAI",
    "defaultProvider": true,
    "uploadSupported": true
  }
]

Returns the default provider. Returns 404 if no provider is configured.

# Request
GET /api/ai/providers/default HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
{
  "providerId": "Primary Provider",
  "displayName": "Primary Provider",
  "providerType": "openai",
  "providerTypeDisplayName": "OpenAI",
  "defaultProvider": true,
  "uploadSupported": true
}

Returns one provider by name token. The token may be the exact display name or the hyphenized form. Returns 404 for an unknown provider or for nested paths with more than one token. Other HTTP methods return 405.

# Request
# "Primary Provider" can also be addressed as Primary-Provider
GET /api/ai/providers/Primary-Provider HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
{
  "providerId": "Primary Provider",
  "displayName": "Primary Provider",
  "providerType": "openai",
  "providerTypeDisplayName": "OpenAI",
  "defaultProvider": true,
  "uploadSupported": true
}