---
title: "Create Session"
method: POST
path: "/v1/in-context/sessions"
tags: ["in-context"]
---

# Create Session

`POST /v1/in-context/sessions`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/in-context/sessions`
- Auth: none declared

Open an in-context editing session for a project (dashboard, dual-auth).

Requires the org's add-on active (billing entitlement) + the project's
per-project opt-in + translator-level project access. Returns the session
plus a QR payload {pairingToken, channel, rtUrl} — valid only while the
session is active.

## Request body

- SessionCreateIn
  - `project_id` string, required
  - `target_locales` string[]
  - `ttl_minutes` integer

## Response `200`

Successful Response

- SessionCreateOut
  - `session` AppRoutesInContextSessionOut, required
    - `id` string, required
    - `projectId` string, required
    - `status` 'pending' | 'active' | 'ended', required
    - `targetLocales` string[], required
    - `channel` string, required
    - `rtUrl` string, required
    - `subscriberToken` string, nullable
    - `paired` boolean, required
    - `pairedDevice` string, nullable
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required
    - `endedAt` string, date-time, nullable
    - `lastActivityAt` string, date-time, nullable
    - `lastSeenKeys` object, nullable
    - `editsCount` integer
  - `qr` SessionQR, required
    - `pairingToken` string, required
    - `pairingCode` string, required
    - `channel` string, required
    - `rtUrl` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sonenta/apis/sonenta-api.md) · [All operations](https://skmtc.dev/sonenta/apis/sonenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonenta/apis/sonenta-api/revisions/f853ea49fb05?raw)