> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r3al.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Runtime and demo sessions

> Inspect the model connection and control a configured managed session.

## Access status

```text theme={null}
GET /v1/projects/{project_id}/access
```

Accepts an account-linked API key or a signed-in session. Returns `project`, `model`, `runtime`, `ready`, `demo`, `can_control_demo`, `chat_path`, and `endpoint_path`.

`runtime.state` is one of `not_connected`, `offline`, `loading`, `ready`, or `unavailable`. During preparation, `runtime.phase` may report `fetching_manifest`, `downloading_checkpoint`, `verifying_checkpoint`, or `loading_weights`. Wait for `ready: true` before sending inference.

```bash theme={null}
curl "https://platform.r3al.ai/v1/projects/$R3AL_PROJECT_ID/access" \
  -H "Authorization: Bearer $R3AL_API_KEY"
```

## Start a demo

```text theme={null}
POST /v1/projects/{project_id}/demo/start
```

Requires a signed-in admin or developer session and a configured serverless runtime with demo controls enabled. API keys cannot start compute.

```json theme={null}
{ "minutes": 30 }
```

The API accepts whole minutes from 5 to 60; the UI offers 15, 30, and 60. Returns `{ "demo": ... }` with the session state and expiry. Loading consumes part of this duration. An active session is not extended by repeatedly starting it.

## Stop a demo

```text theme={null}
POST /v1/projects/{project_id}/demo/stop
```

Requires the same session role. No request body is needed. Shutdown is asynchronous: wait for `demo.state` to become `stopped`. The durable deadline also requests shutdown if the browser closes.

These endpoints control configured pilot runtimes. They are not general-purpose APIs to provision arbitrary models or GPU infrastructure.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.