---
title: "Create Demo Session"
method: POST
path: "/demo/create-demo-session"
tags: ["DEMO"]
---

# Create Demo Session

`POST /demo/create-demo-session`

Create or retrieve a demo user and generate a temporary session ID.

This endpoint creates a dedicated demo user in the demo tenant for the calling tenant.
Each tenant gets exactly one demo user (1-to-1 mapping) with email: demo@{calling_tenant}.
Returns a session ID that expires in 30 minutes and can be used once to authenticate.

Returns:
    DemoSessionResponse: Contains the demo tenant frontend URL and session ID

## Response `200`

Successful Response

- DemoSessionResponse
  - `demoUrl` string, required
  - `sessionId` string, required

## Other responses

- `404` — Demo tenant not found
- `500` — Failed to create demo session

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/50769cbf05d5/schema)