Skip to main content
POST
Error

Authorizations

X-API-Key
string
header
required

Body

application/json

Schema used for creating feedback.

key
string
required
Maximum string length: 180
created_at
string<date-time>
modified_at
string<date-time>
score
value
comment
string | null
correction
feedback_group_id
string<uuid> | null
comparative_experiment_id
string<uuid> | null
run_id
string<uuid> | null
session_id
string<uuid> | null

Required unless the feedback is addressed by agent_id and agent_environment. The ID of the tracing project (session) the feedback belongs to.

agent_id
string | null

Beta. Only supported in workspaces where Agent addressing is enabled; other workspaces get a 403. The Agent's id, not a UUID: 1 to 63 lowercase ASCII letters, digits, or hyphens, starting with a letter and ending with a letter or digit (e.g. support-agent). Addresses the tracing project through an Agent instead of session_id. Sent together with agent_environment, and never alongside session_id. The Agent and the environment must already exist; sending feedback does not create them.

agent_environment
enum<string> | null

Beta. Only supported in workspaces where Agent addressing is enabled; other workspaces get a 403. The Agent environment whose tracing project the feedback belongs to. Matched case-insensitively. Sent together with agent_id.

Available options:
LOCAL,
DEVELOPMENT,
STAGING,
PRODUCTION
address
object

Beta. Only supported in workspaces where Agent addressing is enabled; other workspaces get a 403. Addresses the tracing project through an Agent environment instead of session_id. Never combined with agent_id, agent_environment, or session_id. The Agent and the environment must already exist; sending feedback does not create them.

trace_id
string<uuid> | null
start_time
string<date-time> | null
feedback_thread_id
string | null
extend_trace_retention
boolean
default:true
id
string<uuid>
feedback_source
AppFeedbackSource · object

Feedback from the LangChainPlus App.

feedback_config
FeedbackConfig · object | null
error
boolean | null
deprecated

Deprecated. Use extra.error instead. If both values are provided, error takes precedence.

extra
Extra · object | null

Response

Successful Response

Schema for getting feedback.

key
string
required
id
string<uuid>
required
created_at
string<date-time>
modified_at
string<date-time>
score
value
comment
string | null
correction
feedback_group_id
string<uuid> | null
comparative_experiment_id
string<uuid> | null
run_id
string<uuid> | null
session_id
string<uuid> | null
trace_id
string<uuid> | null
start_time
string<date-time> | null
is_root
boolean
default:false
feedback_source
FeedbackSource · object | null

The feedback source loaded from the database.

extra
Extra · object | null
feedback_thread_id
string | null