Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

Creates an empty session owned by the caller and returns its id. The body is optional: set a title or a provider, model and tool config.

Request

Request body

titlestring

Human-readable session label

clientIdstring

Client identifier for version vector tracking (auto-generated as web_<ts> if omitted)

configobject

Responses

`201` Created

Session created

Response shape:

idstring (uuid)

New session UUID (UUIDv7)

createdAtstring (date-time)

`400` Bad Request

Invalid request

Response shape: object

`401` Unauthorized

Authentication required

Response shape: object

`429` Too Many Requests

Rate limit exceeded

Response shape: object

curl -X POST 'https://ivybiosciences.com/api/harness/sessions' \
  -H "Authorization: Bearer $IVY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'

POST /harness/sessions

Request

Request body

Responses

201 Created

400 Bad Request

401 Unauthorized

429 Too Many Requests

`201` Created

`400` Bad Request

`401` Unauthorized

`429` Too Many Requests