Skip to main content
POST
https://api.unify.ai
/
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"
        }
    },
    "derived": false
}'

{
    "info": "Created 3 derived logs with key='example_key'.",
    "derived_log_ids": [
        101,
        102,
        103
    ]
}
Creates one or more entries based on body.equation and body.referenced_logs. When body.derived=True (default): Eagerly computes each derived value and stores it in DerivedLog.value. When body.derived=False: Computes values and stores them directly in the base logs as regular entries. 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.
​
derived
boolean
default:"true"
Whether to create derived logs (True) or static entries in base logs (False).
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"
        }
    },
    "derived": false
}'

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