---
title: "Changes to Invoke function"
method: POST
path: "/v1/function/{function_id}/invoke"
---

# Changes to Invoke function

`POST /v1/function/{function_id}/invoke`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 101 revisions.

- **2026-10-30** `8f5039399f77`: 23 breaking
- **2026-10-30** `01a2a9298945`: 1 info
- **2026-09-22** `2e0e9e00d0bd`: 1 info
- **2026-08-13** `e05ef145579d`: 8 info
- **2026-05-21** `7c3461755f69`: 1 info
- **2026-01-13** `97c5791b3df1`: 1 warning
- **2026-01-08** `c7496daaaa37`: 4 info
- **2025-12-04** `b6967d956e2f`: 2 info
- **2025-08-15** `a3fce07a60cf`: 1 breaking, 1 info
- **2025-07-16** `29c3853d6db5`: 1 info
- **2025-06-17** `77a2d5797d94`: 4 breaking, 14 info
- **2024-09-30** `ac2727014d93`: 1 breaking, 2 info
- **2024-09-24** `a774951c03d7`: 3 info
- **2024-09-23** `35ca662bf690`: 1 breaking, 1 info
- **2024-09-21** `1e677afe2f7b`: 2 info
- **2024-07-30** `9635568dd298`: 1 info

## Changes

- **2026-10-30** `8f5039399f77`: 23 breaking
  - the request property `endpoint_name` became not nullable
  - the request property `expected` became not nullable
  - the request property `input` became not nullable
  - the request property `messages/items/anyOf[subschema #3: assistant]/function_call` became not nullable
  - the request property `messages/items/anyOf[subschema #3: assistant]/name` became not nullable
  - the request property `messages/items/anyOf[subschema #3: assistant]/reasoning` became not nullable
  - the request property `messages/items/anyOf[subschema #3: assistant]/reasoning/items/content` became not nullable
  - the request property `messages/items/anyOf[subschema #3: assistant]/reasoning/items/id` became not nullable
  - the request property `messages/items/anyOf[subschema #3: assistant]/reasoning_signature` became not nullable
  - the request property `messages/items/anyOf[subschema #3: assistant]/tool_calls` became not nullable
  - the request property `messages/items/anyOf[subschema #5: function]/content` became not nullable
  - the request property `messages/items/anyOf[subschema #7: fallback]/content` became not nullable
  - the request property `metadata` became not nullable
  - the request property `metadata/additionalProperties/` became not nullable
  - the request property `mode` became not nullable
  - the request property `overrides` became not nullable
  - the request property `overrides/additionalProperties/` became not nullable
  - the request property `parent/anyOf[subschema #1: span_parent_struct]/propagated_event` became not nullable
  - the request property `parent/anyOf[subschema #1: span_parent_struct]/propagated_event/additionalProperties/` became not nullable
  - the request property `parent/anyOf[subschema #1: span_parent_struct]/row_ids` became not nullable
  - the request property `stream` became not nullable
  - the request property `strict` became not nullable
  - the request property `tags` became not nullable
- **2026-10-30** `01a2a9298945`: 1 info
  - added the new optional request property `request_source`
- **2026-09-22** `2e0e9e00d0bd`: 1 info
  - added `#/components/schemas/ChatCompletionContentPartInputAudioWithTitle` to the `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/` request property `anyOf` list
- **2026-08-13** `e05ef145579d`: 8 info
  - added the new optional request property `endpoint_name`
  - added the new optional request property `messages/items/anyOf[subschema #1: system]/content/anyOf[subschema #2: array]/items/cache_control/ttl`
  - added the new optional request property `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/anyOf[subschema #1: text]/cache_control/ttl`
  - added the new optional request property `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/anyOf[subschema #2: image_url]/cache_control`
  - added the new optional request property `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/anyOf[subschema #3: file]/cache_control`
  - added the new optional request property `messages/items/anyOf[subschema #3: assistant]/content/anyOf[subschema #2]/items/cache_control/ttl`
  - added the new optional request property `messages/items/anyOf[subschema #4: tool]/content/anyOf[subschema #2: array]/items/cache_control/ttl`
  - added the new optional request property `messages/items/anyOf[subschema #6: developer]/content/anyOf[subschema #2: array]/items/cache_control/ttl`
- **2026-05-21** `7c3461755f69`: 1 info
  - added the new optional request property `messages/items/anyOf[subschema #3: assistant]/reasoning_signature`
- **2026-01-13** `97c5791b3df1`: 1 warning
  - removed the request property `context`
- **2026-01-08** `c7496daaaa37`: 4 info
  - added the new optional request property `context`
  - added the new optional request property `overrides`
  - added the new `json` enum value to the request property `mode`
  - added the new `text` enum value to the request property `mode`
- **2025-12-04** `b6967d956e2f`: 2 info
  - added the new optional request property `mcp_auth`
  - added `#/components/schemas/ChatCompletionContentPartFileWithTitle` to the `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/` request property `anyOf` list
- **2025-08-15** `a3fce07a60cf`: 1 breaking, 1 info
  - removed `#/components/schemas/ChatCompletionContentPartImage, subschema #1` from the `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/` request property `anyOf` list
  - added `#/components/schemas/ChatCompletionContentPartTextWithTitle, #/components/schemas/ChatCompletionContentPartImageWithTitle` to the `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/` request property `anyOf` list
- **2025-07-16** `29c3853d6db5`: 1 info
  - added `subschema #6: developer` to the `messages/items/` request property `anyOf` list
- **2025-06-17** `77a2d5797d94`: 4 breaking, 14 info
  - removed `#/components/schemas/ChatCompletionContentPartText` from the `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/` request property `anyOf` list
  - the request property `messages/items/anyOf[subschema #3: assistant]/content` became not nullable
  - the request property `messages/items/anyOf[subschema #5: function]/content` became required
  - the response's body became nullable
  - added the new optional request property `expected`
  - added the new optional request property `messages/items/anyOf[subschema #3: assistant]/reasoning`
  - added the new optional request property `metadata`
  - added the new optional request property `strict`
  - added the new optional request property `tags`
  - added `subschema #1` to the `messages/items/anyOf[subschema #2: user]/content/anyOf[subschema #2: array]/items/` request property `anyOf` list
  - the request property `messages/items/anyOf[subschema #5: function]/content` became nullable
  - the `content` request property default value `` was removed
  - the `content` request property default value `` was removed
  - the `content` request property default value `` was removed
  - added the new `playground_logs` enum value to the request property `parent/anyOf[subschema #1: span_parent_struct]/object_type`
  - request property `messages/items/anyOf[subschema #1: system]/content` list-of-types was widened by adding types `array` to media type `application/json`
  - request property `messages/items/anyOf[subschema #3: assistant]/content` list-of-types was widened by adding types `array and null` to media type `application/json`
  - request property `messages/items/anyOf[subschema #4: tool]/content` list-of-types was widened by adding types `array` to media type `application/json`
- **2024-09-30** `ac2727014d93`: 1 breaking, 2 info
  - the response's body became nullable
  - the request property `input` became nullable
  - the request property `parent/anyOf[subschema #1: span_parent_struct]/propagated_event/additionalProperties/` became nullable
- **2024-09-24** `a774951c03d7`: 3 info
  - added the new optional request property `messages`
  - added the new optional request property `mode`
  - the request property `stream` became nullable
- **2024-09-23** `35ca662bf690`: 1 breaking, 1 info
  - removed `subschema #1` from the `parent` request property `anyOf` list
  - added `subschema #1: span_parent_struct` to the `parent` request property `anyOf` list
- **2024-09-21** `1e677afe2f7b`: 2 info
  - added the new optional request property `parent/anyOf[subschema #1]/propagated_event`
  - added the new optional request property `parent/anyOf[subschema #1]/row_ids`
- **2024-07-30** `9635568dd298`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/braintrustdata/apis/braintrust-api/docs/v1/function/:function_id/invoke/post.md) - [API](https://skmtc.dev/braintrustdata/apis/braintrust-api.md) - [Page](https://skmtc.dev/braintrustdata/apis/braintrust-api/changes/v1/function/:function_id/invoke/post)