Point a scenario at a different environment
Keeps the scenario’s LINK, its members and its session history while changing what visitors actually reach. The alternative — unpublish and republish — mints a new link, which means re-sharing it with everyone.
The new environment must belong to THIS project; one that does not answers 404 rather than confirming it exists elsewhere.
Authorizations
MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.
Path Parameters
ID of the hosted project that contains the server.
Scenario ID, as returned by publishing an environment or by the project's scenario reads.
Body
The environment to point this scenario at. Must belong to the SAME project.
Response
The scenario now points at the new environment.
A published environment: what a visitor lands on when you share a link.
Who may open the share link:
project_members— signed-in members of the project onlyinvited_only— named members, invited individuallyanyone_with_link— anyone holding the URL, signed in or not
project_members, invited_only, anyone_with_link Bumped whenever access NARROWS — a mode change, or a member removal. Sessions minted under an older version stop working, which is what makes those changes take effect at once rather than at expiry. A link ROTATION is deliberately not one of them: it mints a new URL without bumping this, so anyone who already redeemed the old link keeps working. Rotating is half of closing a leak — see the rotate-link operation.
The share link. null when the scenario has no link token.
False when the environment was ALREADY published and this returned the existing scenario. Publishing is idempotent, so this is how you tell "I published it" from "it was already there" without a preflight read.
True when the create-time overrides (name, description, mode) were NOT applied because the environment was already published. Paired with created: false — change an existing scenario with PATCH .../user-testing/scenarios/{scenarioId}.

