POST
/
v4
/
interactions
/

Authorizations

x-api-key
string
headerrequired

Headers

x-selected-account-id
string

Body

application/json
application_variant_id
string
required

Identifier for the application variant that performed this interaction.

thread_id
string

Optional UUID identifying the conversation thread associated with the interaction.The interaction will be associated with the thread if the id represents an existing thread.If the thread with the specified id is not found, a new thread will be created.

input
object
required

The input data for the interaction.

output
object
required

The output data from the interaction.

start_timestamp
string
required

Timestamp marking the start of the interaction.

duration_ms
integer
default: 0

Duration of the interaction in milliseconds.

operation_status
enum<string>
default: SUCCESS

The outcome status of the interaction.

Available options:
SUCCESS,
ERROR
operation_metadata
object

Optional metadata related to the operation, including custom or predefined keys.

trace_spans
object[]

List of trace spans associated with the interaction.These spans provide insight into the individual steps taken by nodes involved in generating the output.

Response

200 - application/json
application_variant_id
string
required

Identifier for the application variant that performed this interaction.

thread_id
string

Optional UUID identifying the conversation thread associated with the interaction.The interaction will be associated with the thread if the id represents an existing thread.If the thread with the specified id is not found, a new thread will be created.

input
object
required

The input data for the interaction.

output
object
required

The output data from the interaction.

start_timestamp
string
required

Timestamp marking the start of the interaction.

duration_ms
integer
default: 0

Duration of the interaction in milliseconds.

operation_status
enum<string>
default: SUCCESS

The outcome status of the interaction.

Available options:
SUCCESS,
ERROR
operation_metadata
object

Optional metadata related to the operation, including custom or predefined keys.

trace_spans
object[]

List of trace span entities associated with the interaction.

id
string
required

Unique identifier for the interaction.