---
title: "Create Dataset Log"
method: POST
path: "/api/datasets/{dataset_id}/logs/"
tags: ["datasets"]
---

# Create Dataset Log

`POST /api/datasets/{dataset_id}/logs/`

Create a single dataset log from unified format data

Endpoint:
    POST /api/datasets/{dataset_id}/logs/ - Create individual dataset log

Args (POST body - unified format):
    - input (any): The input data (messages, text, etc.)
    - output (any): The output data (response, completion, etc.)
    - metadata (object, optional): Additional metadata fields (model, log_type, etc.)
    - metrics (object, optional): Metric fields (tokens, cost, latency, etc.)

Note: model and log_type can be provided either as top-level fields or within metadata object

Returns (POST 201):
    { "message": "Dataset log created successfully", "unique_id": "log-123..." }

## Path parameters

- `dataset_id` string, required

## Headers

- `Authorization` string, required

## Request body

- DatasetLogCreateRequestRequest
  - `input` unknown, required
  - `output` unknown
  - `metadata` unknown
  - `metrics` unknown

## Response `201`

- DatasetLogCreateResponse
  - `message` string, required
  - `unique_id` string, required

## Changes

- **2026-07-31** `c26d550029f8` — 4 breaking, 1 warning, 1 info
  - removed `subschema #1, subschema #2, subschema #3` from the `input` request property `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `output` request property `oneOf` list
  - the `metadata` request property type/format changed from `object`/`` to ``/``
  - the `metrics` request property type/format changed from `object`/`` to ``/``
  - …2 more
- **2026-07-26** `77d94e49bc7a` — 3 info
  - added the new optional request property `expected_output`
  - added `subschema #1, subschema #2, subschema #3` to the `input` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `output` request property `oneOf` list

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/datasets/:dataset_id/logs/post.md)

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c26d550029f8/schema)