Skip to main content
POST
Create a session
Use this endpoint to start a conversation and get an EDN-generated ID for it. It’s optional: you can also choose your own session_id, and EDN creates the session the first time you use it.

What EDN does

Creates the session and returns its ID.

Required headers

Request

Response

200 OK

Errors

See Error handling.

Authorizations

Authorization
string
header
required

Your EDN API key, sent as Bearer YOUR_API_KEY. Create keys in the Console.

Body

application/json
title
string | null

A title for the session. Defaults to "New conversation".

Example:

"Website planning"

Response

Successful Response

created_at
string
required

When the session was created (ISO 8601, UTC).

id
string
required

The new session's ID. Use it as session_id in other calls.

title
string
required

The session's title.