Skip to content

Organization settings

The Organization tab in the API Portal's Settings page manages the details of the organization you're signed in to.

Editing organization details

  1. Log in to the API Portal & MCP Hub as an admin and navigate to Settings.
  2. Under the ORGANIZATION group, select the Organization tab.
  3. Update any of the following fields:
Field Description
Name The display name shown throughout the portal UI
Handle The URL-safe identifier used in every portal URL (/api-portal/<orgHandle>/views/<viewName>). Read-only—it can't be changed after the organization is created
Artifact types served Read-only. Shows which artifact types the portal serves—APIs, Model Context Protocol (MCP) servers, and API workflows. Set by the operator in the [api_portal.artifacts] config, not from this pane; pages for a type that isn't served return 404. See Artifact types
Business owner Contact name for the organization owner
Business owner contact The owner's phone number or other contact string
Business owner email The owner's email address
IDP reference ID The organization claim value your identity provider (IDP) asserts at single sign-on (SSO) login, which incoming tokens are resolved against. Read-only here, because it's what every token is matched against, so saving a different value fails. For the configured organization, it comes from [api_portal.auth] idp_org_id and defaults to the handle. For an organization that multi-organization mode provisions, it's the organization claim the organization was created from. See Connect an identity provider
Control plane reference ID Reference ID included in outbound webhook event payloads (org.ref_id). Not used for authentication
  1. Click Save changes.

Note

This page only manages the organization you're currently in—it doesn't create or delete organizations. Organization creation happens once, automatically, when the portal is provisioned.