POST
/
v4
/
interactions
/

Authorizations

x-api-key
string
headerrequired

Headers

x-selected-account-id
string | null

Body

application/json

Represents an interaction performed with an application, including input, output, and associated metadata.

application_variant_id
string
required

Identifier for the application variant that performed this interaction.

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.

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.

duration_ms
integer
default: 0

Duration of the interaction in milliseconds.

operation_status
enum<string>

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.

input_guardrail_results
object[]

Results of the guardrails executed on the input

output_guardrail_results
object[]

Results of the guardrails executed on the output

Response

200 - application/json

Model representing an interaction entity.

application_variant_id
string
required

Identifier for the application variant that performed this interaction.

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.

id
string
required

Unique identifier for the 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.

duration_ms
integer
default: 0

Duration of the interaction in milliseconds.

operation_status
enum<string>

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.

input_guardrail_results
object[]

Results of the guardrails executed on the input

output_guardrail_results
object[]

Results of the guardrails executed on the output