List organizations with rebranding enabled

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 /rebranding/organizations

Bearer auth

Scoped to the caller: the owner sees every enabled organization, everyone else only their own subtree.

Query parameters

page integer

Page number

Minimum value is 1. Default value is 1.
page_size integer

Items per page

Minimum value is 1, maximum value is 200. Default value is 20.
sort_by string

Field to sort the organizations with rebranding by

Values are name, organization_type, enabled_at, or updated_at.
sort_direction string

Sort direction

Values are asc or desc. Default value is asc.
search string

Matches the organization name

Minimum length is 1.
type array[string]

Repeatable. Organization types to keep.

Values are distributor, reseller, or customer.
product array[string]

Repeatable. Keeps organizations that have branded at least one of these products.

Responses

200 application/json

Organizations retrieved
Hide response attributes Show response attributes object
- code integer
- message string
- data object
  
  Hide data attributes Show data attributes object
  
  organizations array[object]
  
  An organization with rebranding enabled, and the products it has branded.
  
  Hide organizations attributes Show organizations attributes object
  
  An organization with rebranding enabled, and the products it has branded.
  
  id string
  
  Database UUID of the organization
  
  logto_id string
  
  Logto organization ID
  
  name string
  
  organization_type string
  
  Values are distributor, reseller, or customer.
  
  products array[object]
  
  Hide products attributes Show products attributes object
  
  product_id string
  
  product_display_name string
  
  product_name string | null
  
  enabled_at string(date-time)
  
  updated_at string(date-time) | null
  
  Most recent write across the organization's products; null if nothing is configured yet
  
  pagination object
  
  Hide pagination attributes Show pagination attributes object
  
  page integer
  
  Current page number
  
  Minimum value is 1.
  
  page_size integer
  
  Number of items per page
  
  Minimum value is 1, maximum value is 200.
  
  total_count integer
  
  Total number of items
  
  Minimum value is 0.
  
  total_pages integer
  
  Total number of pages
  
  Minimum value is 0.
  
  has_next boolean
  
  Whether there is a next page
  
  has_prev boolean
  
  Whether there is a previous page
  
  next_page integer | null
  
  Next page number if available
  
  prev_page integer | null
  
  Previous page number if available
  
  sort_by string | null
  
  Field used for sorting
  
  sort_direction string | null
  
  Sort direction
  
  Values are asc or desc.
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 /rebranding/organizations

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

Response examples (200)

{
  "code": 42,
  "message": "string",
  "data": {
    "organizations": [
      {
        "id": "string",
        "logto_id": "string",
        "name": "CloudPoint srl",
        "organization_type": "distributor",
        "products": [
          {
            "product_id": "nethvoice",
            "product_display_name": "NethVoice",
            "product_name": "UrbanGrid"
          }
        ],
        "enabled_at": "2026-05-04T09:42:00Z",
        "updated_at": "2026-05-04T09:42:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_count": 156,
      "total_pages": 8,
      "has_next": true,
      "has_prev": false,
      "next_page": 2,
      "prev_page": 42,
      "sort_by": "name",
      "sort_direction": "asc"
    }
  }
}

Response examples (401)

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

Response examples (403)

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