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

# AmbientSessionStatus Type

> Lifecycle status values for an Ambient session in the Headless Web SDK

## Type definition

**`sessionStatus`** from **`useAmbientSession`** lets you know the Ambient session lifecycle on Suki's servers. Examples include `created` and `submitted`.

<Warning>
  Do not use **`sessionStatus`** for recording versus paused. Keep a local **`phase`** value such as `idle`, `recording`, or `paused`. Update **`phase`** when you call `start`, `pause`, or `resume`.
</Warning>

```tsx theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
type AmbientSessionStatus =
  | "created"
  | "submitted"
  | "completed"
  | "cancelled"
  | "aborted"
  | "failed"
  | "skipped"
  | "not_found"
  | "error";
```

| Value                                                    | When you see it                                                  |
| -------------------------------------------------------- | ---------------------------------------------------------------- |
| `created`                                                | Session exists and you can start recording.                      |
| `submitted`                                              | Recording finished and the session was submitted for processing. |
| `completed`                                              | Note generation finished.                                        |
| `cancelled`                                              | Session was cancelled.                                           |
| `aborted` / `failed` / `skipped` / `not_found` / `error` | Terminal or error outcomes. Handle these in your UI as needed.   |

See [Manage ambient session](/headless-web-sdk/guides/hooks/ambient-session-hook) for recording controls and examples that use local `phase` together with `sessionStatus`.