## Summary

Adds synchronous and asynchronous vault updates and metadata filtering.

## Changes

- Update a vault name or replace its metadata.
- Filter vaults and credentials by metadata key-value pairs.

- Preserve empty-string query filter values while continuing to omit
`None`.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Documents Files API rate-limit responses for agent environment file
uploads and session creation.

## Changes

- Describe HTTP 429 responses for environment file uploads and session
creation.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Documents the 128-character maximum for safety identifiers.

## Changes

- Update safety_identifier descriptions and API reference constraints to
reflect the 128-character limit.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Clarifies the supported input, question types, and declined answers in
the Decisions API.

## Changes

- Describe predicate, choice, and score questions.
- Clarify shared evidence inputs and that one declined question does not
prevent other answers.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Adds billing_not_active to session-turn error codes.

## Changes

- Recognize the session error code for accounts whose billing is not
active.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Adds shida to the named built-in Live voices.

## Changes

- Expose shida in the built-in voice type while retaining all existing
voice names and open-string inputs.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Clarifies the input formats and refusal results for decision creation.

## Changes

- Describe text and image inputs, the 128-image limit, and per-question
refusal results.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Clarifies the number and uniqueness requirements for decision choices.

## Changes

- Document that choice questions require between 2 and 255 unique
choices.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

## Summary

Aligns beta agent pagination with the API’s shared validation rules.

## Changes

Beta agent pagination now follows shared API validation: page sizes must
be 1–100 (default 20). Session, vault, and vault-credential listings
reject out-of-range limits with HTTP 400 instead of clamping them. Omit
optional pagination arguments to use defaults. List parameter
annotations no longer include `None` for the five list limits or the
artifact `after` cursor. Prefer omitting these arguments; existing
Python `None` serialization still omits them.

Affected beta resources: agents, sessions, session artifacts, vaults,
and vault credentials (`beta.agents`). The corresponding HTTP paths are
`/agents`, `/agents/sessions`,
`/agents/sessions/{session_id}/artifacts`, `/vaults`, and
`/vaults/{vault_id}/credentials`.

## Compatibility and migration

This follows the beta API’s move to shared pagination validation. Omit
`limit` to use 20, or supply an integer from 1 through 100. Omit `after`
to start at the first page. Artifact listing already enforced the
numeric range; the newly rejected out-of-range requests identified here
are session, vault, and vault-credential listings.

The change remains within the beta surface and does not use a
major-version marker.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

Automated Release PR
---


##
[3.29.0](v3.28.0...v3.29.0)
(2026-10-11)


### Features

* **api:** add billing_not_active session error code
([#4052](#4052))
([c88b320](c88b320))
* **api:** add shida to named Live voices
([#4053](#4053))
([7352cf5](7352cf5))
* **api:** add vault updates and metadata filters
([#4047](#4047))
([e72f493](e72f493))
* **api:** align beta pagination limits and non-null parameters
([#4057](#4057))
([800899e](800899e))


### Chores

* **api:** clarify decision creation documentation
([#4054](#4054))
([16d3d3b](16d3d3b))
* **api:** clarify Decisions question and answer descriptions
([#4051](#4051))
([895d617](895d617))
* **api:** document 128-character safety identifiers
([#4050](#4050))
([2c1ae52](2c1ae52))
* **api:** document decision choice constraints
([#4055](#4055))
([b7a1990](b7a1990))
* **api:** document Files API rate-limit responses
([#4049](#4049))
([f6a3459](f6a3459))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: openai-sdks[bot] <284451331+openai-sdks[bot]@users.noreply.github.com>