---
title: "Start session (specific environment)"
method: POST
path: "/v4/project/{projectID}/environment/{environmentID}/session"
tags: ["Session", "Public-Docs"]
---

# Start session (specific environment)

`POST /v4/project/{projectID}/environment/{environmentID}/session`

Start a new conversation and get a session key for interacting with an agent in a specified environment.

## Path parameters

- `projectID` string, required — The ID of the target Voiceflow project. You can find it in the settings for your agent.
- `environmentID` string, required — The alias of the environment to target (ie. `main`). You can find this in the environments page of your agent.

## Request body

- object
  - `userID` string, required — Unique ID for the user. If a session already exists for this user, the existing session will end and a new session will be created with a new session key.

## Response `200`

- object
  - `sessionKey` string, required — A session-scoped authentication key. Pass this as the `authorization` header when calling the interact endpoints.

---

[API](https://skmtc.dev/voiceflow/apis/general-runtime.md) · [All operations](https://skmtc.dev/voiceflow/apis/general-runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voiceflow/general-runtime/revisions/6b1c4f778c56/schema)