---
title: "Api Create Session"
method: POST
path: "/v1/session"
tags: ["embed v1"]
---

# Api Create Session

`POST /v1/session`

## Request

- Base URL: `https://api.branchly.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.branchly.io/v1/session`
- Auth: none declared

## Headers

- `x-api-key` string, nullable

## Request body

- SessionCreateRequest
  - `navigator_id` string, uuid, required
  - `id` string, uuid, required
  - `embed_type` 'chat' | 'search' | 'chat_widget' | 'search_interface' | 'voice' | 'api' | 'form', required

## Response `202`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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