Skip to main content
Change a portal’s slug, display name, the resource it serves, its enabled state, or its branding. Unreleased and subject to change without notice. Only the fields you send change. Omitting a field leaves it unchanged. For branding fields, sending null clears the value. Send at most one of keyspaceId or appId. Re-pointing the portal at another resource revokes its live sessions because each session carries the scope it was minted with. Disabling the portal stops new sessions but leaves live sessions running until they expire. Your root key must have portal.*.update_portal or portal.<portal_id>.update_portal. Without permission, this endpoint returns 404, not 403.

​
Usage

​
Flags

​
string
required
Portal ID or slug.
​
string
New URL-safe portal handle.
​
string
New human-readable name shown to end users.
​
string
ID of the new keyspace to serve. You cannot combine this with --app-id.
​
string
ID of the new app to serve. You cannot combine this with --keyspace-id.
​
bool
Whether new sessions can be minted. Omit this flag to leave the setting unchanged.
​
string or null
Absolute https:// logo URL. Pass null to remove the logo.
​
string or null
Six-digit hex colour. Pass null to restore the default styling.

​
Global Flags

​
Examples

See the API reference.
Last modified on September 18, 2026