POST
/
v0
/
logs
/
derived
curl --request POST \
  --url 'https://api.unify.ai/v0/logs/derived' \
  --header "Authorization: Bearer $UNIFY_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "project": "eval-project",
    "context": "experiment1/trial1",
    "key": "score_diff",
    "equation": "{log0:score} - {log1:score}",
    "referenced_logs": {
        "log0": [
            0,
            1,
            2
        ],
        "log1": {
            "filter_expr": "score > 0.5"
        }
    }
}'

{
    "info": "Created 3 derived logs with key='example_key'.",
    "derived_log_ids": [
        101,
        102,
        103
    ]
}

Creates one or more derived-log entries based on body.equation and body.referenced_logs. Eagerly computes each derived value and stores it in DerivedLog.value.

The context parameter can be:

  • A string: Uses the string as the context name with default values (description=None, is_versioned=False)
  • An object: Uses the object’s name, description, and is_versioned properties

​
Authorizations

​
Authorization
string
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Body

​
project
string
required

Name of the project the stored entries will be associated to.

​
context
any | string | null

Optional context path to update for the logs. Can use ’/’ for nested contexts (e.g. ‘training/batch1’). Can be a string (which will be interpreted with description=None and is_versioned=False) or a ContextCreateRequest object.

​
key
string
required

The name of the entry.

​
equation
string
required

The equation for computing the value of each derived entry.

​
referenced_logs
object
required

The logs to use for each newly created derived entry, either as a list of log ids or as a set of arguments for the get_logs endpoint.

curl --request POST \
  --url 'https://api.unify.ai/v0/logs/derived' \
  --header "Authorization: Bearer $UNIFY_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "project": "eval-project",
    "context": "experiment1/trial1",
    "key": "score_diff",
    "equation": "{log0:score} - {log1:score}",
    "referenced_logs": {
        "log0": [
            0,
            1,
            2
        ],
        "log1": {
            "filter_expr": "score > 0.5"
        }
    }
}'

{
    "info": "Created 3 derived logs with key='example_key'.",
    "derived_log_ids": [
        101,
        102,
        103
    ]
}