/third-party-applications/catalog - Portals a distributor can be granted

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 /third-party-applications/catalog

Bearer auth

The catalogue the Owner organization picks from when it sets a distributor's third_party_apps: every third-party application whose access_control admits a partner organization role (distributor, reseller or customer) and pins no organization id. Owner organization only.

Responses

200 application/json

Catalogue retrieved successfully
Hide response attributes Show response attributes object
- code integer
- message string
- data array[object]
  
  One portal a distributor can be granted: a third-party application whose own access_control admits a partner organization role and pins no organization id. The name is the stable key (identical across Logto tenants); the display name comes from the application branding.
  
  Hide data attributes Show data attributes object
  
  One portal a distributor can be granted: a third-party application whose own access_control admits a partner organization role and pins no organization id. The name is the stable key (identical across Logto tenants); the display name comes from the application branding.
  
  name string Required
  
  Application name as registered in Logto and in the sync config
  
  display_name string Required
  
  Display name from the application branding (falls back to the name)
  
  description string
  
  Application description
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
500 application/json

Internal server error
Hide response attributes Show response attributes object
- code integer
- message string
- data object | null

GET /third-party-applications/catalog

curl \
 --request GET 'https://my.nethesis.it/backend/api/third-party-applications/catalog' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "code": 200,
  "message": "third-party applications catalogue retrieved successfully",
  "data": [
    {
      "name": "nethshop.nethesis.it",
      "display_name": "NethShop",
      "description": "NethShop Nethesis"
    }
  ]
}

Response examples (401)

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

Response examples (403)

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

Response examples (500)

{
  "code": 500,
  "message": "internal server error",
  "data": {}
}