/filters/applications - Get aggregated application filters

GET /filters/applications
Bearer auth

Aggregated endpoint that returns all application filter data in a single request. RBAC is resolved once, then types, versions, systems, and organizations are fetched in parallel.

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

Organizations special value: If there are applications without an assigned organization, the response includes a special "No organization" entry with id: "no_org" and type: "unassigned".

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
        • 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)

      • systems array[object]

        Minimal system info for application responses

        Hide systems attributes Show systems attributes object
        • id string

          System ID

        • name string

          System name

      • organizations array[object]

        Simplified organization for selection and assignment

        Hide organizations attributes Show organizations attributes object
        • id string

          Database UUID of the organization (or "no_org" for unassigned filter)

        • logto_id string

          Logto organization ID (or "no_org" for unassigned filter)

        • name string

          Organization name

        • description string

          Organization description

        • type string

          Organization type ("unassigned" is the special "No organization" filter entry)

          Values are owner, distributor, reseller, customer, or unassigned.
  • 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,
  "data": {
    "types": [
      {
        "name": "NethVoice",
        "count": 15,
        "instance_of": "nethvoice"
      },
      {
        "name": "Mail",
        "count": 8,
        "instance_of": "mail"
      }
    ],
    "systems": [
      {
        "id": "abc123-system-uuid",
        "name": "Production Server"
      },
      {
        "id": "def456-system-uuid",
        "name": "Development Server"
      }
    ],
    "versions": [
      {
        "name": "Mail",
        "versions": [
          "mail:1.7.4"
        ],
        "application": "mail"
      },
      {
        "name": "NethVoice",
        "versions": [
          "nethvoice:1.5.4",
          "nethvoice:1.5.3"
        ],
        "application": "nethvoice"
      }
    ],
    "organizations": [
      {
        "id": "no_org",
        "name": "No organization",
        "type": "unassigned",
        "logto_id": "no_org",
        "description": ""
      },
      {
        "id": "8b04e253-d408-4218-a30e-b048196847e5",
        "name": "Acme Corp",
        "type": "customer",
        "logto_id": "fso3biosnaqp",
        "description": ""
      }
    ]
  },
  "message": "application filters retrieved successfully"
}
Response examples (401) 
{
  "code": 401,
  "message": "invalid token",
  "data": {}
}
Response examples (403) 
{
  "code": 403,
  "message": "insufficient permissions",
  "data": {}
}