Update session metadata

patch

https://api.newo.ai/api/v1/sessions/{id}

Asynchronously updates metadata on a session. The update is applied via a
session_updated event — the response is immediate but the change may take
a moment to propagate.

Use this endpoint to mark a session as a lead, record success/failure, add a
comment, or set other outcome fields after the conversation ends.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

uuid

required

Session UUID

Body Params

Fields to update on a session. All properties are optional — only provided
fields are updated.

session_type

string

Type or category label for the session

is_test

boolean

Mark this session as a test session (excluded from production metrics)

expected_result

string

Description of the expected outcome, for QA and review purposes

result_success

boolean | null

Whether the session achieved its goal (null = unreviewed)

is_lead

boolean

Flag this session as a captured lead

comment

string

Free-text note or comment about the session

conversation_penalty

number | null

Penalty applied to the conversation quality score

is_todo

boolean

Flag this session for follow-up action

is_archived

boolean

Archive this session to remove it from active views

lead_value

number

Estimated monetary value of this lead

is_opportunity

boolean

Flag this session as a sales opportunity

agent_success_human

number

Human-rated agent success score (0–1 scale)

Responses

200

Session update event queued successfully

4XXNewo API error