/user/permissions - Get user permissions (OAuth2/OIDC)

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

mcp.json 
{
  "my.nethesis.it MCP server": {
    "url": "https://api.my.nethesis.it/mcp"
  }
}
Close
GET /user/permissions
Bearer auth

Get current user permissions using standard OAuth2/OIDC flow with Logto token

Responses

  • 200 application/json

    User permissions retrieved successfully

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object
      Hide data attributes Show data attributes object
      • user_roles array[string]
      • user_permissions array[string]
      • org_role string
      • org_permissions array[string]
      • organization_id string
      • organization_name string
  • 401 application/json

    Unauthorized - invalid or missing token

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
GET /user/permissions 
curl \
 --request GET 'https://api.your-domain.com/api/user/permissions' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "code": 200,
  "message": "user permissions retrieved successfully",
  "data": {
    "user_roles": [
      "Admin"
    ],
    "user_permissions": [
      "manage:systems",
      "read:systems"
    ],
    "org_role": "Owner",
    "org_permissions": [
      "manage:resellers",
      "create:customers"
    ],
    "organization_id": "org_123456789",
    "organization_name": "ACME Corp"
  }
}
Response examples (401) 
{
  "code": 401,
  "message": "invalid token",
  "data": {}
}