release: 12.3.0 (#597)

* chore(internal): version bump

* fix(mcp): include required section for top-level properties and support naming transformations

* fix: Make all the regexes for webhook payloads more explicit, to fix `video.asset.static_rendition.*` webhooks (#360)

* codegen metadata

* feat: add more languages for live generated captions (#361)

* chore: remove log from internal build step (#362)

* feat: Spec for latest thumbnail (#363)

* chore(internal): codegen related update

* codegen metadata

* codegen metadata

* feat(api): expose /system/v1/whoami route

* release: 12.3.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "12.2.0"
+  ".": "12.3.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 106
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mux%2Fmux-211713a01eb052da5f6732bba658d2436bf866412bfa310c690d8983f267cbbc.yml
-openapi_spec_hash: ad58459421d76cb976989951c6656816
-config_hash: 2093578740c6c695af8b0a84e6deebb0
+configured_endpoints: 107
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mux%2Fmux-323c1dc63b7a75cbabd3a79dcf80ca0afc9c0ae234f4323a39240a4a841583b9.yml
+openapi_spec_hash: e8fda4e033c6d0e7bc9ee4c629c232fa
+config_hash: 16b19b97f99dd7265b4619c5a999c751

CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 12.3.0 (2025-07-24)
+
+Full Changelog: [v12.2.0...v12.3.0](https://github.com/muxinc/mux-node-sdk/compare/v12.2.0...v12.3.0)
+
+### Features
+
+* add more languages for live generated captions ([#361](https://github.com/muxinc/mux-node-sdk/issues/361)) ([6dc6350](https://github.com/muxinc/mux-node-sdk/commit/6dc6350f64d07ba9c4e185a6128540eab28c80b5))
+* **api:** expose /system/v1/whoami route ([3fa346b](https://github.com/muxinc/mux-node-sdk/commit/3fa346b461f2aad57d4c87194c91c69a6668748d))
+* Spec for latest thumbnail ([#363](https://github.com/muxinc/mux-node-sdk/issues/363)) ([72f8669](https://github.com/muxinc/mux-node-sdk/commit/72f8669588736e4c72324792bda69f24c01213c8))
+
+
+### Bug Fixes
+
+* Make all the regexes for webhook payloads more explicit, to fix `video.asset.static_rendition.*` webhooks ([#360](https://github.com/muxinc/mux-node-sdk/issues/360)) ([f276b25](https://github.com/muxinc/mux-node-sdk/commit/f276b252dfad47d0fa2b4d435505f935a17c327a))
+* **mcp:** include required section for top-level properties and support naming transformations ([6c2ea9f](https://github.com/muxinc/mux-node-sdk/commit/6c2ea9fe8bd7b952c57da816ce29938710b3e529))
+
+
+### Chores
+
+* **internal:** codegen related update ([dc7ea3e](https://github.com/muxinc/mux-node-sdk/commit/dc7ea3ed285180e0f426b5d5b594dc832db60cb0))
+* **internal:** version bump ([997eca2](https://github.com/muxinc/mux-node-sdk/commit/997eca2ef922a37ada5fc996e48e852ac0424b0a))
+* remove log from internal build step ([#362](https://github.com/muxinc/mux-node-sdk/issues/362)) ([c06d7e2](https://github.com/muxinc/mux-node-sdk/commit/c06d7e2b18eeb3095a1232fc67c83ee5e4fd933c))
+
 ## 12.2.0 (2025-07-16)
 
 Full Changelog: [v12.1.0...v12.2.0](https://github.com/muxinc/mux-node-sdk/compare/v12.1.0...v12.2.0)

api.md

@@ -356,6 +356,17 @@ Methods:
 - <code title="get /system/v1/signing-keys">client.system.signingKeys.<a href="./src/resources/system/signing-keys.ts">list</a>({ ...params }) -> SigningKeysBasePage</code>
 - <code title="delete /system/v1/signing-keys/{SIGNING_KEY_ID}">client.system.signingKeys.<a href="./src/resources/system/signing-keys.ts">delete</a>(signingKeyId) -> void</code>
 
+## Utilities
+
+Types:
+
+- <code><a href="./src/resources/system/utilities.ts">WhoamiResponse</a></code>
+- <code><a href="./src/resources/system/utilities.ts">UtilityWhoamiResponse</a></code>
+
+Methods:
+
+- <code title="get /system/v1/whoami">client.system.utilities.<a href="./src/resources/system/utilities.ts">whoami</a>() -> UtilityWhoamiResponse</code>
+
 # Webhooks
 
 Types:

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mux/mux-node",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "description": "The official TypeScript library for the Mux API",
   "author": "Mux <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -346,3 +346,7 @@ The following tools are available in this MCP server.
   **The private key is not returned in this response.**
 - `list_system_signing_keys` (`read`): Returns a list of signing keys.
 - `delete_system_signing_keys` (`write`): Deletes an existing signing key. Use with caution, as this will invalidate any existing signatures and no JWTs can be signed using the key again.
+
+### Resource `system.utilities`:
+
+- `whoami_system_utilities` (`read`): Retrieve information about your current access token, including organization, environment, and permissions. Note that this can only be access with an access token, and _all_ access tokens can access this route, regardless of what permissions they have assigned.

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mux/mcp",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "description": "The official MCP Server for the Mux API",
   "author": "Mux <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/server.ts

@@ -26,7 +26,7 @@ export { endpoints } from './tools';
 export const server = new McpServer(
   {
     name: 'mux',
-    version: '12.2.0',
+    version: '12.3.0',
   },
   { capabilities: { tools: {} } },
 );

packages/mcp-server/src/tools/data/annotations/create-data-annotations.ts

@@ -41,7 +41,9 @@ export const tool: Tool = {
           'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
       },
     },
+    required: ['date', 'note'],
   },
+  annotations: {},
 };
 
 export const handler = async (client: Mux, args: Record<string, unknown> | undefined) => {

packages/mcp-server/src/tools/data/annotations/delete-data-annotations.ts

@@ -31,6 +31,10 @@ export const tool: Tool = {
           'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
       },
     },
+    required: ['ANNOTATION_ID'],
+  },
+  annotations: {
+    idempotentHint: true,
   },
 };