Skip to main content
GET
Get one conversation

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Path Parameters

conversation_id
string
required

The conversation's id, from GET /v1/conversations

Response

200 - application/json

Successful Response

activity_id
string
required

Its thread: on the timeline at GET /v1/activities/{activity_id} (a thread started in the portal or the in-app chat has none there)

ai
ConversationAi · object
required
created_at
string
required

ISO 8601 UTC

id
string
required
updated_at
string
required

ISO 8601 UTC: its last change, else its creation

account_id
string | null

The account it is about; null when none resolved

agent
ConversationAgent · object | null

The AI that covers it; null when none does

assignee
ConversationAssignee · object | null

The person it is assigned to

channel
enum<string> | null

email, slack, teams, portal or in_app_sdk

Available options:
portal,
in_app_sdk,
email,
slack,
teams,
ticket
close_reason
enum<string> | null

answered, no_reply, quiet, person (a person closed it) or person_reply (a person's reply settled it); null unless its status is Closed

Available options:
answered,
no_reply,
quiet,
person,
person_reply
closed_at
string | null

ISO 8601 UTC; null unless its status is Closed (cleared on a reopen)

customer_told_at
string | null

ISO 8601 UTC: when the customer was last told about the engineering issue

engineering_issue
ConversationEngineeringIssue · object | null

The engineering issue it was handed to; null when none

first_reply_at
string | null

ISO 8601 UTC: when the first reply, from the AI or a person, reached the customer

kind
enum<string> | null

support (a support AI's conversation) or customer_success (any other AI's); null when no AI covers the thread

Available options:
customer_success,
support
last_message_at
string | null

ISO 8601 UTC: its thread's latest message

outcome
enum<string> | null

knowledge, account_data, engineering, person or none; null unless its status is Closed

Available options:
knowledge,
account_data,
engineering,
person,
none
priority
enum<string> | null

normal or urgent, as a person set it; null when nobody has

Available options:
normal,
urgent
reopen_count
integer
default:0

How many times it reopened after closing

started_by
enum<string> | null

Who wrote the thread's first message: customer, user (a teammate), digital_worker (the AI's own outreach) or system; null when it can't be told

Available options:
customer,
user,
digital_worker,
system
status
string | null

The workspace's own status name, such as NEEDS RESPONSE

status_group
enum<string> | null

The status's group: not_started, active, done or archived, as a task's

Available options:
not_started,
active,
done,
archived
subject
string | null

The thread's title, else its first message's email subject

tags
ConversationTag · object[]