/filters/applications - Get aggregated application filters

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://api.my.nethesis.it/mcp

Standard setup for AI tools providing an mcp.json file

{
  "my.nethesis.it MCP server": {
    "url": "https://api.my.nethesis.it/mcp"
  }
}

GET /filters/applications

Bearer auth

Returns the catalog of application types and versions available in the caller's scope. RBAC is resolved once, then types and versions are fetched in parallel.

Version Format: Returns versions in prefixed format type:version (e.g., "nethvoice:1.5.3", "mail:1.7.4").

Systems and organizations dropdowns are populated by the dedicated /api/systems and /api/organizations endpoints, which support search and pagination.

Responses

200 application/json

Application filters retrieved successfully
Hide response attributes Show response attributes object
- code integer
- message string
- data object
  
  Hide data attributes Show data attributes object
  
  types array[object]
  
  Application type metadata (only user-facing types are returned)
  
  Hide types attributes Show types attributes object
  
  Application type metadata (only user-facing types are returned)
  
  instance_of string
  
  Application type identifier (lowercase, e.g., nethvoice, webtop, mail)
  
  name string
  
  Human-readable name of the application type (e.g., NethVoice, WebTop)
  
  count integer
  
  Number of applications of this type
  
  versions array[object]
  
  Hide versions attributes Show versions attributes object
  
  application string
  
  Application type (instance_of)
  
  name string
  
  Human-readable application name
  
  versions array[string]
  
  Prefixed versions (type:version)
401 application/json

Unauthorized - invalid or missing token
Hide response attributes Show response attributes object
- code integer
- message string
- data object | null
403 application/json

Forbidden - insufficient permissions
Hide response attributes Show response attributes object
- code integer
- message string
- data object | null

GET /filters/applications

curl \
 --request GET 'https://api.your-domain.com/api/filters/applications' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "code": 200,
  "message": "application filters retrieved successfully",
  "data": {
    "types": [
      {
        "instance_of": "nethvoice",
        "name": "NethVoice",
        "count": 15
      },
      {
        "instance_of": "mail",
        "name": "Mail",
        "count": 8
      }
    ],
    "versions": [
      {
        "application": "mail",
        "name": "Mail",
        "versions": [
          "mail:1.7.4"
        ]
      },
      {
        "application": "nethvoice",
        "name": "NethVoice",
        "versions": [
          "nethvoice:1.5.4",
          "nethvoice:1.5.3"
        ]
      }
    ]
  }
}

Response examples (401)

{
  "code": 401,
  "message": "invalid token",
  "data": {}
}

Response examples (403)

{
  "code": 403,
  "message": "insufficient permissions",
  "data": {}
}