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¶
- Log in to the API Portal & MCP Hub as an admin and navigate to Settings.
- Under the ORGANIZATION group, select the Organization tab.
- 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. Effectively read-only—the portal sets it to the organization handle when the organization is created, and saving a different value fails, because it's what every token is matched against. To have an IDP's organization claim resolve here, align it with the handle instead: see Connect an identity provider |
| Control plane reference ID | Reference ID included in outbound webhook event payloads (org.ref_id). Not used for authentication |
- 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.