v1

latestOpenAPI 3.1.02026-07-13154170539.0 KB
Logs

Update Derived Log

Updates multiple derived logs, identified either by a direct list of derived IDs or by get_logs–style filters. If 'referenced_logs' is provided, we delete all existing derived logs for each (log_event_id, key) group and re-insert new ones referencing the new base logs. Finally, we recompute them.

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
put/v0/logs/derived

Request body

project_namestring required

Name of the project these derived logs belong to.

keystring nullable

New key name for the derived entries

equationstring nullable

New equation for computing derived values

referenced_logsobject nullable

Optional new referenced logs to use for computation. Can be specified either as a list of log IDs or as a set of arguments for the get_logs endpoint.

Example request

{
  "project_name": "eval-project",
  "context": {
    "name": "experiment1/trial1",
    "description": "Context for experiment 1 trial 1",
    "is_versioned": true,
    "allow_duplicates": true,
    "unique_keys": {
      "company_id": "int",
      "department_id": "int",
      "first_name": "str",
      "last_name": "str"
    },
    "auto_counting": {
      "company_id": "department_id"
    },
    "foreign_keys": [
      {
        "default": 0,
        "name": "department_id",
        "on_delete": "SET DEFAULT",
        "on_update": "CASCADE",
        "references": "Departments.id"
      }
    ]
  },
  "key": "temp_plus_20",
  "equation": "{t:temperature} + 20",
  "referenced_logs": {
    "other": {
      "filter_expr": "score > 0.5"
    },
    "t": [
      1,
      2,
      3
    ]
  }
}

Response

Derived log updated successfully

{"stackTrail":"paths:/v0/logs/derived:put:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}