For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inBook a demo
DocsReferenceChangelog
DocsReferenceChangelog
  • Introduction
    • SDKs
    • Errors
  • Humanloop API
      • GETGet
      • GETList Datapoints
      • POSTCreate
      • POSTLog
      • POSTResult
      • PATCHUpdate Status
      • PATCHAdd Evaluators
      • GETGet Evaluations
LogoLogo
Sign inBook a demo
Humanloop APIEvaluations

Log

POST
https://api.humanloop.com/v4/evaluations/:evaluation_id/log
POST
/v4/evaluations/:evaluation_id/log
$curl -X POST https://api.humanloop.com/v4/evaluations/evaluation_id/log \
>     -H "X-API-KEY: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "datapoint_id": "datapoint_id",
>  "log": {}
>}'
1{
2  "id": "id",
3  "project_id": "project_id",
4  "session_id": "session_id"
5}
Log an external generation to an evaluation run for a datapoint. The run must have status 'running'.
Was this page helpful?
Previous

Result

Next
Built with

Authentication

X-API-KEYstring
API Key authentication via header

Path parameters

evaluation_idstringRequired

ID of the evaluation run. Starts with evrun_.

Query parameters

evaluatee_idstringOptional

String ID of evaluatee version to return. If not defined, the first evaluatee will be returned. Starts with evv_.

Request

This endpoint expects an object.
datapoint_idstringRequired
The datapoint for which a log was generated. Must be one of the datapoints in the dataset being evaluated.
logobjectRequired
The log generated for the datapoint.

Response

Successful Response
idstring

String ID of logged datapoint. Starts with data_.

project_idstring

String ID of project the datapoint belongs to. Starts with pr_.

session_idstring

String ID of session the datapoint belongs to. Populated only if the datapoint was logged with session_id or session_reference_id, and is None otherwise. Starts with sesh_.

Errors

422
Evaluations Log Request Unprocessable Entity Error