Change the globally unique frontend path slug.
Atomically reserves the requested slug, checks for collisions and updates the global instance configuration using optimistic version control. Real changes are limited to one every 30 days and append an immutable audit event in the same transaction. Only activeUrl returned by this operation is the canonical working frontend link. Earlier slugs remain reserved for this instance but are not aliases.
ROLES: INSTANCE_ADMIN USER: true SERVICE ACCOUNT: true
Authorizations
Bearer JWT token or API Key (sk-*).
Body
New globally unique frontend path identifier. The returned activeUrl is the only canonical link after the update. Previously used slugs remain reserved for this instance but are not active aliases. After activation, another change is blocked for 30 days.
6 - 30^[a-z][a-z0-9-]{4,28}[a-z0-9]$"tenant-production"
Must be true to confirm that earlier slug links will stop resolving and another real slug change will be blocked for 30 days.
true true
Current global instance configuration version used for optimistic concurrency control.
x >= 012
Response
Internal instance UUID. API authorization and backend state continue to use this identifier.
"159836b3-a831-4c8c-bb7d-c9b91b455a7c"
Current frontend path identifier after the transaction commits.
"tenant-production"
Previous active slug, or null when the instance did not have one.
"tenant-stage"
Canonical frontend link that is active after the update. Earlier slug links are not aliases and stop resolving.
"https://app.revoengine.com/tenant-production"
Timestamp when this slug became active, or null when an unchanged legacy slug has no recorded activation time.
"2026-09-18T10:00:00.000Z"
Earliest timestamp at which another slug change is allowed, or null when no cooldown has started.
"2026-10-18T10:00:00.000Z"
Global instance configuration version after the update.
13

