/me/api-keys - List current user's API keys

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 /me/api-keys
Bearer auth

List the personal API keys owned by the current user. Secrets are never returned. This endpoint is interactive-session only and cannot be called with an API key.

Responses

  • 200 application/json

    API keys retrieved successfully

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object
      Hide data attribute Show data attribute object
      • api_keys array[object]

        A personal API key. The secret part of the token is never returned after creation.

        Hide api_keys attributes Show api_keys attributes object

        A personal API key. The secret part of the token is never returned after creation.

        • id string
        • user_id string

          Local database ID of the owner

        • organization_id string
        • name string

          Human label for the integration this key serves

        • key_public string

          Public part of the token (for display/identification only)

        • mode string

          read = read:* only; write = read:* + manage:* (destroy/impersonate/alert-config excluded)

          Values are read or write.

        • expires_at string(date-time)
        • last_used_at string(date-time) | null
        • last_used_ip string | null
        • revoked_at string(date-time) | null
        • created_at string(date-time)
  • 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 /me/api-keys 
curl \
 --request GET 'https://api.your-domain.com/api/me/api-keys' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "code": 200,
  "message": "api keys retrieved successfully",
  "data": {
    "api_keys": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "user_id": "jf584cz36kce",
        "organization_id": "org_a1b2c3",
        "name": "CRM production",
        "key_public": "a1b2c3d4e5f60718293a4b5c",
        "mode": "read",
        "expires_at": "2026-05-04T09:42:00Z",
        "last_used_at": "2026-05-04T09:42:00Z",
        "last_used_ip": "string",
        "revoked_at": "2026-05-04T09:42:00Z",
        "created_at": "2026-05-04T09:42:00Z"
      }
    ]
  }
}
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": {}
}