--- title: "Changes to Insert experiment events" method: POST path: "/v1/experiment/{experiment_id}/insert" --- # Changes to Insert experiment events `POST /v1/experiment/{experiment_id}/insert` > Every recorded change to this operation, newest first. ## Timeline Changed in 19 of 101 revisions. - **2026-10-30** `8f5039399f77`: 46 breaking - **2026-10-15** `aa86a5dee6e9`: 1 info - **2026-09-22** `2e0e9e00d0bd`: 2 info - **2026-09-10** `d4fca10d8584`: 1 info - **2026-09-03** `ebac33c1422e`: 1 breaking - **2026-06-03** `46b20afded4f`: 1 breaking - **2026-04-08** `a21b724fece9`: 1 info - **2026-02-10** `4918f9bd942e`: 1 info - **2026-02-02** `8dda984bb502`: 1 info - **2026-01-23** `79b5f945907c`: 1 info - **2026-01-13** `97c5791b3df1`: 3 info - **2026-01-08** `c7496daaaa37`: 1 info - **2025-08-15** `a3fce07a60cf`: 3 breaking, 6 info - **2025-06-17** `77a2d5797d94`: 2 breaking, 20 info - **2024-09-30** `ac2727014d93`: 5 breaking, 16 info - **2024-08-08** `344821ebe826`: 2 info - **2024-07-23** `9eeeeb30b963`: 3 info - **2024-05-10** `a44e16cb39fc`: 2 info - **2024-05-06** `44b51ad3239a`: 48 info ## Changes - **2026-10-30** `8f5039399f77`: 46 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/context` became not nullable - the request property `events/items/context/additionalProperties/` became not nullable - the request property `events/items/context/caller_filename` became not nullable - the request property `events/items/context/caller_functionname` became not nullable - the request property `events/items/context/caller_lineno` became not nullable - the request property `events/items/created` became not nullable - the request property `events/items/error` 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/metrics` became not nullable - the request property `events/items/metrics/caller_filename` became not nullable - the request property `events/items/metrics/caller_functionname` became not nullable - the request property `events/items/metrics/caller_lineno` became not nullable - the request property `events/items/metrics/completion_tokens` became not nullable - the request property `events/items/metrics/end` became not nullable - the request property `events/items/metrics/prompt_tokens` became not nullable - the request property `events/items/metrics/start` became not nullable - the request property `events/items/metrics/tokens` 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/output` became not nullable - the request property `events/items/root_span_id` became not nullable - the request property `events/items/scores` became not nullable - the request property `events/items/scores/additionalProperties/` became not nullable - the request property `events/items/span_attributes` became not nullable - the request property `events/items/span_attributes/additionalProperties/` became not nullable - the request property `events/items/span_attributes/log_level` became not nullable - …6 more - **2026-10-15** `aa86a5dee6e9`: 1 info - added the new `decision` enum value to the request property `events/items/span_attributes/type` - **2026-09-22** `2e0e9e00d0bd`: 2 info - added the new optional request property `events/items/span_attributes/log_level` - added the new `question` enum value to the request property `events/items/span_attributes/type` - **2026-09-10** `d4fca10d8584`: 1 info - added the new `log` enum value to the request property `events/items/span_attributes/type` - **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-04-08** `a21b724fece9`: 1 info - added the new optional request property `events/items/span_attributes/purpose` - **2026-02-10** `4918f9bd942e`: 1 info - added the new `review` enum value to the request property `events/items/span_attributes/type` - **2026-02-02** `8dda984bb502`: 1 info - added the new optional request property `events/items/facets` - **2026-01-23** `79b5f945907c`: 1 info - added the new `classifier` enum value to the request property `events/items/span_attributes/type` - **2026-01-13** `97c5791b3df1`: 3 info - added the new `automation` enum value to the request property `events/items/span_attributes/type` - added the new `facet` enum value to the request property `events/items/span_attributes/type` - added the new `preprocessor` enum value to the request property `events/items/span_attributes/type` - **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, 20 info - removed `#/components/schemas/InsertExperimentEventReplace, #/components/schemas/InsertExperimentEventMerge` 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/context` - added the new optional request property `events/items/created` - added the new optional request property `events/items/error` - 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/metrics` - added the new optional request property `events/items/origin` - added the new optional request property `events/items/output` - added the new optional request property `events/items/root_span_id` - added the new optional request property `events/items/scores` - added the new optional request property `events/items/span_attributes` - 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, 16 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/InsertExperimentEventMerge]/context/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/error` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/expected` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/input` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metadata/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/output` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/span_attributes/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/context/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/error` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/expected` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/input` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metadata/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/output` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/span_attributes/additionalProperties/` became nullable - **2024-08-08** `344821ebe826`: 2 info - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/error` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/error` - **2024-07-23** `9eeeeb30b963`: 3 info - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/created` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/created` - request body became optional - **2024-05-10** `a44e16cb39fc`: 2 info - added the new `undefined` enum value to the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/span_attributes/type` - added the new `undefined` enum value to the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/span_attributes/type` - **2024-05-06** `44b51ad3239a`: 48 info - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics/completion_tokens` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics/prompt_tokens` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics/tokens` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/tags` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics/completion_tokens` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics/prompt_tokens` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics/tokens` - added the new optional request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/tags` - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/_merge_paths` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/_object_delete` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/context` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/context/caller_filename` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/context/caller_functionname` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/context/caller_lineno` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/dataset_record_id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metadata` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics/end` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/metrics/start` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/scores` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/scores/additionalProperties/` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/span_attributes` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/span_attributes/name` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventMerge]/span_attributes/type` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/_is_merge` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/_object_delete` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/_parent_id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/context` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/context/caller_filename` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/context/caller_functionname` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/context/caller_lineno` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/dataset_record_id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/id` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metadata` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics/end` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/metrics/start` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/scores` became nullable - the request property `events/items/anyOf[#/components/schemas/InsertExperimentEventReplace]/scores/additionalProperties/` became nullable - …8 more --- [Operation](https://skmtc.dev/braintrustdata/apis/braintrust-api/docs/v1/experiment/:experiment_id/insert/post.md) - [API](https://skmtc.dev/braintrustdata/apis/braintrust-api.md) - [Page](https://skmtc.dev/braintrustdata/apis/braintrust-api/changes/v1/experiment/:experiment_id/insert/post)