--- title: "Changes to Insert dataset events" method: POST path: "/v1/dataset/{dataset_id}/insert" --- # Changes to Insert dataset events `POST /v1/dataset/{dataset_id}/insert` > Every recorded change to this operation, newest first. ## Timeline Changed in 10 of 101 revisions. - **2026-10-30** `8f5039399f77`: 22 breaking - **2026-09-03** `ebac33c1422e`: 1 breaking - **2026-06-03** `46b20afded4f`: 1 breaking - **2026-02-02** `8dda984bb502`: 1 info - **2026-01-08** `c7496daaaa37`: 1 info - **2025-08-15** `a3fce07a60cf`: 3 breaking, 6 info - **2025-06-17** `77a2d5797d94`: 2 breaking, 14 info - **2024-09-30** `ac2727014d93`: 5 breaking, 6 info - **2024-07-23** `9eeeeb30b963`: 3 info - **2024-05-06** `44b51ad3239a`: 2 warning, 18 info ## Changes - **2026-10-30** `8f5039399f77`: 22 breaking - the request property `events/items/_array_delete` became not nullable - the request property `events/items/_array_delete/items/delete/items/` became not nullable - the request property `events/items/_is_merge` became not nullable - the request property `events/items/_merge_paths` became not nullable - the request property `events/items/_object_delete` became not nullable - the request property `events/items/_parent_id` became not nullable - the request property `events/items/created` became not nullable - the request property `events/items/expected` became not nullable - the request property `events/items/facets` became not nullable - the request property `events/items/facets/additionalProperties/` became not nullable - the request property `events/items/id` became not nullable - the request property `events/items/input` became not nullable - the request property `events/items/metadata` became not nullable - the request property `events/items/metadata/additionalProperties/` became not nullable - the request property `events/items/metadata/model` became not nullable - the request property `events/items/origin` became not nullable - the request property `events/items/origin/_xact_id` became not nullable - the request property `events/items/origin/created` became not nullable - the request property `events/items/root_span_id` became not nullable - the request property `events/items/span_id` became not nullable - the request property `events/items/span_parents` became not nullable - the request property `events/items/tags` became not nullable - **2026-09-03** `ebac33c1422e`: 1 breaking - request body became required - **2026-06-03** `46b20afded4f`: 1 breaking - the `events/items/facets/additionalProperties/` request property type changed from no type to `string` - **2026-02-02** `8dda984bb502`: 1 info - added the new optional request property `events/items/facets` - **2026-01-08** `c7496daaaa37`: 1 info - added the new optional request property `events/items/_array_delete` - **2025-08-15** `a3fce07a60cf`: 3 breaking, 6 info - removed `subschema #1, subschema #2` from the `events/items/origin/object_type` request property `anyOf` list - request property `events/items/origin/object_type` was restricted to a list of enum values - the `events/items/origin/object_type` request property type changed from no type to `string` - added the new `dataset` enum value to the request property `events/items/origin/object_type` - added the new `experiment` enum value to the request property `events/items/origin/object_type` - added the new `function` enum value to the request property `events/items/origin/object_type` - added the new `project_logs` enum value to the request property `events/items/origin/object_type` - added the new `prompt` enum value to the request property `events/items/origin/object_type` - added the new `prompt_session` enum value to the request property `events/items/origin/object_type` - **2025-06-17** `77a2d5797d94`: 2 breaking, 14 info - removed `#/components/schemas/InsertDatasetEventReplace, #/components/schemas/InsertDatasetEventMerge` from the `events/items/` request property `anyOf` list - the `events/items/` request property type changed from no type to `object` - added the new optional request property `events/items/_is_merge` - added the new optional request property `events/items/_merge_paths` - added the new optional request property `events/items/_object_delete` - added the new optional request property `events/items/_parent_id` - added the new optional request property `events/items/created` - added the new optional request property `events/items/expected` - added the new optional request property `events/items/id` - added the new optional request property `events/items/input` - added the new optional request property `events/items/metadata` - added the new optional request property `events/items/origin` - added the new optional request property `events/items/root_span_id` - added the new optional request property `events/items/span_id` - added the new optional request property `events/items/span_parents` - added the new optional request property `events/items/tags` - **2024-09-30** `ac2727014d93`: 5 breaking, 6 info - the response's body became nullable - the response's body became nullable - the response's body became nullable - the response's body became nullable - the response's body became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/expected` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/input` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/metadata/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/expected` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/input` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/metadata/additionalProperties/` became nullable - **2024-07-23** `9eeeeb30b963`: 3 info - added the new optional request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/created` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/created` - request body became optional - **2024-05-06** `44b51ad3239a`: 2 warning, 18 info - removed the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/output` - removed the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/output` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/expected` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/tags` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/expected` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/tags` - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/_merge_paths` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/_object_delete` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/metadata` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/_is_merge` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/_object_delete` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/_parent_id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/metadata` became nullable - added the media type `application/json` for the response with the status `400` - added the media type `application/json` for the response with the status `401` - added the media type `application/json` for the response with the status `403` - added the media type `application/json` for the response with the status `500` - added the non-success response with the status `429` --- [Operation](https://skmtc.dev/braintrustdata/apis/braintrust-api/docs/v1/dataset/:dataset_id/insert/post.md) - [API](https://skmtc.dev/braintrustdata/apis/braintrust-api.md) - [Page](https://skmtc.dev/braintrustdata/apis/braintrust-api/changes/v1/dataset/:dataset_id/insert/post)