--- title: "Changes to Cross-object insert" method: POST path: "/v1/insert" --- # Changes to Cross-object insert `POST /v1/insert` > Every recorded change to this operation, newest first. ## Timeline Changed in 18 of 101 revisions. - **2026-10-30** `8f5039399f77`: 144 breaking - **2026-10-15** `aa86a5dee6e9`: 2 info - **2026-09-22** `2e0e9e00d0bd`: 4 info - **2026-09-10** `d4fca10d8584`: 2 info - **2026-06-03** `46b20afded4f`: 3 breaking - **2026-04-08** `a21b724fece9`: 2 info - **2026-02-10** `4918f9bd942e`: 2 info - **2026-02-02** `8dda984bb502`: 3 info - **2026-01-23** `79b5f945907c`: 2 info - **2026-01-13** `97c5791b3df1`: 6 info - **2026-01-08** `c7496daaaa37`: 3 info - **2025-08-15** `a3fce07a60cf`: 9 breaking, 18 info - **2025-06-17** `77a2d5797d94`: 6 breaking, 57 info - **2024-09-30** `ac2727014d93`: 5 breaking, 43 info - **2024-08-08** `344821ebe826`: 4 info - **2024-07-23** `9eeeeb30b963`: 6 info - **2024-05-10** `a44e16cb39fc`: 7 info - **2024-05-06** `44b51ad3239a`: 1 info ## Changes - **2026-10-30** `8f5039399f77`: 144 breaking - the request property `dataset` became not nullable - the request property `dataset/additionalProperties/events` became not nullable - the request property `dataset/additionalProperties/events/items/_array_delete` became not nullable - the request property `dataset/additionalProperties/events/items/_array_delete/items/delete/items/` became not nullable - the request property `dataset/additionalProperties/events/items/_is_merge` became not nullable - the request property `dataset/additionalProperties/events/items/_merge_paths` became not nullable - the request property `dataset/additionalProperties/events/items/_object_delete` became not nullable - the request property `dataset/additionalProperties/events/items/_parent_id` became not nullable - the request property `dataset/additionalProperties/events/items/created` became not nullable - the request property `dataset/additionalProperties/events/items/expected` became not nullable - the request property `dataset/additionalProperties/events/items/facets` became not nullable - the request property `dataset/additionalProperties/events/items/facets/additionalProperties/` became not nullable - the request property `dataset/additionalProperties/events/items/id` became not nullable - the request property `dataset/additionalProperties/events/items/input` became not nullable - the request property `dataset/additionalProperties/events/items/metadata` became not nullable - the request property `dataset/additionalProperties/events/items/metadata/additionalProperties/` became not nullable - the request property `dataset/additionalProperties/events/items/metadata/model` became not nullable - the request property `dataset/additionalProperties/events/items/origin` became not nullable - the request property `dataset/additionalProperties/events/items/origin/_xact_id` became not nullable - the request property `dataset/additionalProperties/events/items/origin/created` became not nullable - the request property `dataset/additionalProperties/events/items/root_span_id` became not nullable - the request property `dataset/additionalProperties/events/items/span_id` became not nullable - the request property `dataset/additionalProperties/events/items/span_parents` became not nullable - the request property `dataset/additionalProperties/events/items/tags` became not nullable - the request property `dataset/additionalProperties/feedback` became not nullable - the request property `dataset/additionalProperties/feedback/items/comment` became not nullable - the request property `dataset/additionalProperties/feedback/items/metadata` became not nullable - the request property `dataset/additionalProperties/feedback/items/metadata/additionalProperties/` became not nullable - the request property `dataset/additionalProperties/feedback/items/source` became not nullable - the request property `dataset/additionalProperties/feedback/items/tags` became not nullable - the request property `experiment` became not nullable - the request property `experiment/additionalProperties/events` became not nullable - the request property `experiment/additionalProperties/events/items/_array_delete` became not nullable - the request property `experiment/additionalProperties/events/items/_array_delete/items/delete/items/` became not nullable - the request property `experiment/additionalProperties/events/items/_is_merge` became not nullable - the request property `experiment/additionalProperties/events/items/_merge_paths` became not nullable - the request property `experiment/additionalProperties/events/items/_object_delete` became not nullable - the request property `experiment/additionalProperties/events/items/_parent_id` became not nullable - the request property `experiment/additionalProperties/events/items/context` became not nullable - the request property `experiment/additionalProperties/events/items/context/additionalProperties/` became not nullable - …104 more - **2026-10-15** `aa86a5dee6e9`: 2 info - added the new `decision` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `decision` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - **2026-09-22** `2e0e9e00d0bd`: 4 info - added the new optional request property `experiment/additionalProperties/events/items/span_attributes/log_level` - added the new optional request property `project_logs/additionalProperties/events/items/span_attributes/log_level` - added the new `question` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `question` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - **2026-09-10** `d4fca10d8584`: 2 info - added the new `log` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `log` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - **2026-06-03** `46b20afded4f`: 3 breaking - the `dataset/additionalProperties/events/items/facets/additionalProperties/` request property type changed from no type to `string` - the `experiment/additionalProperties/events/items/facets/additionalProperties/` request property type changed from no type to `string` - the `project_logs/additionalProperties/events/items/facets/additionalProperties/` request property type changed from no type to `string` - **2026-04-08** `a21b724fece9`: 2 info - added the new optional request property `experiment/additionalProperties/events/items/span_attributes/purpose` - added the new optional request property `project_logs/additionalProperties/events/items/span_attributes/purpose` - **2026-02-10** `4918f9bd942e`: 2 info - added the new `review` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `review` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - **2026-02-02** `8dda984bb502`: 3 info - added the new optional request property `dataset/additionalProperties/events/items/facets` - added the new optional request property `experiment/additionalProperties/events/items/facets` - added the new optional request property `project_logs/additionalProperties/events/items/facets` - **2026-01-23** `79b5f945907c`: 2 info - added the new `classifier` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `classifier` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - **2026-01-13** `97c5791b3df1`: 6 info - added the new `automation` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `automation` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - added the new `facet` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `facet` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - added the new `preprocessor` enum value to the request property `experiment/additionalProperties/events/items/span_attributes/type` - added the new `preprocessor` enum value to the request property `project_logs/additionalProperties/events/items/span_attributes/type` - **2026-01-08** `c7496daaaa37`: 3 info - added the new optional request property `dataset/additionalProperties/events/items/_array_delete` - added the new optional request property `experiment/additionalProperties/events/items/_array_delete` - added the new optional request property `project_logs/additionalProperties/events/items/_array_delete` - **2025-08-15** `a3fce07a60cf`: 9 breaking, 18 info - removed `subschema #1, subschema #2` from the `dataset/additionalProperties/events/items/origin/object_type` request property `anyOf` list - removed `subschema #1, subschema #2` from the `experiment/additionalProperties/events/items/origin/object_type` request property `anyOf` list - removed `subschema #1, subschema #2` from the `project_logs/additionalProperties/events/items/origin/object_type` request property `anyOf` list - request property `dataset/additionalProperties/events/items/origin/object_type` was restricted to a list of enum values - request property `experiment/additionalProperties/events/items/origin/object_type` was restricted to a list of enum values - request property `project_logs/additionalProperties/events/items/origin/object_type` was restricted to a list of enum values - the `dataset/additionalProperties/events/items/origin/object_type` request property type changed from no type to `string` - the `experiment/additionalProperties/events/items/origin/object_type` request property type changed from no type to `string` - the `project_logs/additionalProperties/events/items/origin/object_type` request property type changed from no type to `string` - added the new `dataset` enum value to the request property `dataset/additionalProperties/events/items/origin/object_type` - added the new `dataset` enum value to the request property `experiment/additionalProperties/events/items/origin/object_type` - added the new `dataset` enum value to the request property `project_logs/additionalProperties/events/items/origin/object_type` - added the new `experiment` enum value to the request property `dataset/additionalProperties/events/items/origin/object_type` - added the new `experiment` enum value to the request property `experiment/additionalProperties/events/items/origin/object_type` - added the new `experiment` enum value to the request property `project_logs/additionalProperties/events/items/origin/object_type` - added the new `function` enum value to the request property `dataset/additionalProperties/events/items/origin/object_type` - added the new `function` enum value to the request property `experiment/additionalProperties/events/items/origin/object_type` - added the new `function` enum value to the request property `project_logs/additionalProperties/events/items/origin/object_type` - added the new `project_logs` enum value to the request property `dataset/additionalProperties/events/items/origin/object_type` - added the new `project_logs` enum value to the request property `experiment/additionalProperties/events/items/origin/object_type` - added the new `project_logs` enum value to the request property `project_logs/additionalProperties/events/items/origin/object_type` - added the new `prompt` enum value to the request property `dataset/additionalProperties/events/items/origin/object_type` - added the new `prompt` enum value to the request property `experiment/additionalProperties/events/items/origin/object_type` - added the new `prompt` enum value to the request property `project_logs/additionalProperties/events/items/origin/object_type` - added the new `prompt_session` enum value to the request property `dataset/additionalProperties/events/items/origin/object_type` - added the new `prompt_session` enum value to the request property `experiment/additionalProperties/events/items/origin/object_type` - added the new `prompt_session` enum value to the request property `project_logs/additionalProperties/events/items/origin/object_type` - **2025-06-17** `77a2d5797d94`: 6 breaking, 57 info - removed `#/components/schemas/InsertDatasetEventReplace, #/components/schemas/InsertDatasetEventMerge` from the `dataset/additionalProperties/events/items/` request property `anyOf` list - removed `#/components/schemas/InsertExperimentEventReplace, #/components/schemas/InsertExperimentEventMerge` from the `experiment/additionalProperties/events/items/` request property `anyOf` list - removed `#/components/schemas/InsertProjectLogsEventReplace, #/components/schemas/InsertProjectLogsEventMerge` from the `project_logs/additionalProperties/events/items/` request property `anyOf` list - the `dataset/additionalProperties/events/items/` request property type changed from no type to `object` - the `experiment/additionalProperties/events/items/` request property type changed from no type to `object` - the `project_logs/additionalProperties/events/items/` request property type changed from no type to `object` - added the new optional request property `dataset/additionalProperties/events/items/_is_merge` - added the new optional request property `dataset/additionalProperties/events/items/_merge_paths` - added the new optional request property `dataset/additionalProperties/events/items/_object_delete` - added the new optional request property `dataset/additionalProperties/events/items/_parent_id` - added the new optional request property `dataset/additionalProperties/events/items/created` - added the new optional request property `dataset/additionalProperties/events/items/expected` - added the new optional request property `dataset/additionalProperties/events/items/id` - added the new optional request property `dataset/additionalProperties/events/items/input` - added the new optional request property `dataset/additionalProperties/events/items/metadata` - added the new optional request property `dataset/additionalProperties/events/items/origin` - added the new optional request property `dataset/additionalProperties/events/items/root_span_id` - added the new optional request property `dataset/additionalProperties/events/items/span_id` - added the new optional request property `dataset/additionalProperties/events/items/span_parents` - added the new optional request property `dataset/additionalProperties/events/items/tags` - added the new optional request property `dataset/additionalProperties/feedback/items/tags` - added the new optional request property `experiment/additionalProperties/events/items/_is_merge` - added the new optional request property `experiment/additionalProperties/events/items/_merge_paths` - added the new optional request property `experiment/additionalProperties/events/items/_object_delete` - added the new optional request property `experiment/additionalProperties/events/items/_parent_id` - added the new optional request property `experiment/additionalProperties/events/items/context` - added the new optional request property `experiment/additionalProperties/events/items/created` - added the new optional request property `experiment/additionalProperties/events/items/error` - added the new optional request property `experiment/additionalProperties/events/items/expected` - added the new optional request property `experiment/additionalProperties/events/items/id` - added the new optional request property `experiment/additionalProperties/events/items/input` - added the new optional request property `experiment/additionalProperties/events/items/metadata` - added the new optional request property `experiment/additionalProperties/events/items/metrics` - added the new optional request property `experiment/additionalProperties/events/items/origin` - added the new optional request property `experiment/additionalProperties/events/items/output` - added the new optional request property `experiment/additionalProperties/events/items/root_span_id` - added the new optional request property `experiment/additionalProperties/events/items/scores` - added the new optional request property `experiment/additionalProperties/events/items/span_attributes` - added the new optional request property `experiment/additionalProperties/events/items/span_id` - added the new optional request property `experiment/additionalProperties/events/items/span_parents` - …23 more - **2024-09-30** `ac2727014d93`: 5 breaking, 43 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 `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/expected` became nullable - the request property `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/input` became nullable - the request property `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/metadata/additionalProperties/` became nullable - the request property `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/expected` became nullable - the request property `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/input` became nullable - the request property `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/metadata/additionalProperties/` became nullable - the request property `dataset/additionalProperties/feedback/items/metadata/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/context/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/error` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/expected` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/input` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metadata/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/output` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/span_attributes/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/context/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/error` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/expected` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/input` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metadata/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics/additionalProperties/` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/output` became nullable - the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/span_attributes/additionalProperties/` became nullable - the request property `experiment/additionalProperties/feedback/items/expected` became nullable - the request property `experiment/additionalProperties/feedback/items/metadata/additionalProperties/` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/context/additionalProperties/` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/error` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/expected` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/input` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/metadata/additionalProperties/` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/metrics/additionalProperties/` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/output` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/span_attributes/additionalProperties/` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventReplace]/context/additionalProperties/` became nullable - the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventReplace]/error` became nullable - …8 more - **2024-08-08** `344821ebe826`: 4 info - added the new optional request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/error` - added the new optional request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/error` - added the new optional request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/error` - added the new optional request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventReplace]/error` - **2024-07-23** `9eeeeb30b963`: 6 info - added the new optional request property `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventMerge]/created` - added the new optional request property `dataset/additionalProperties/events/items/anyOf[#/components/schemas/InsertDatasetEventReplace]/created` - added the new optional request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/created` - added the new optional request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/created` - added the new optional request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/created` - added the new optional request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventReplace]/created` - **2024-05-10** `a44e16cb39fc`: 7 info - added the new `undefined` enum value to the request property `dataset/additionalProperties/feedback/items/source` - added the new `undefined` enum value to the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/span_attributes/type` - added the new `undefined` enum value to the request property `experiment/additionalProperties/events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/span_attributes/type` - added the new `undefined` enum value to the request property `experiment/additionalProperties/feedback/items/source` - added the new `undefined` enum value to the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventMerge]/span_attributes/type` - added the new `undefined` enum value to the request property `project_logs/additionalProperties/events/items/anyOf[#/components/schemas/InsertProjectLogsEventReplace]/span_attributes/type` - added the new `undefined` enum value to the request property `project_logs/additionalProperties/feedback/items/source` - **2024-05-06** `44b51ad3239a`: 1 info - endpoint added --- [Operation](https://skmtc.dev/braintrustdata/apis/braintrust-api/docs/v1/insert/post.md) - [API](https://skmtc.dev/braintrustdata/apis/braintrust-api.md) - [Page](https://skmtc.dev/braintrustdata/apis/braintrust-api/changes/v1/insert/post)