> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

## SDK version 1.25.0 Release Notes

This release pins `benchling-api-client` to 2.0.434 and includes a significant SDK-layer addition: rate limit headers are now accessible directly on the `Benchling` object after any API call. On the API side, notable changes include the addition of `v3Id` fields on `AssayResult` and `AssayRun`, a new `base_molecule_link` field type across all tiers, and HTML as a new export format option for notebook entries.

### What's changing?

#### Added

* Rate limit headers are now exposed on the `Benchling` object via `benchling.rate_limit_limit`, `benchling.rate_limit_remaining`, `benchling.rate_limit_reset`, and `benchling.rate_limit_headers` — populated automatically after each API call via an httpx event hook
* `v3Id` read-only field on `AssayResult` — V3 identifier for the result
* `v3Id` read-only field on `AssayRun` — V3 identifier for the run (example: `run_21f50003`)
* `base_molecule_link` enum value on `FieldType` and `AppConfigFieldType`, allowing schema fields and app config fields to reference base molecules
* `format` field on `ExportItemRequest` — choose between `pdf` (default) and `html` export formats for notebook entries
* OAuth `refresh_token` grant type on `TokenCreate`, plus `refresh_token` and `refresh_token_expires_in` fields on `TokenResponse` (alpha only)

#### Changed

* Export item endpoint documentation updated to reflect HTML format support alongside PDF

#### Fixed

* `Collaboration` discriminator mapping keys corrected: `ORGANIZATION_MEMBER` → `ORGANIZATION_MEMBERSHIP`, `TEAM_MEMBER` → `TEAM_MEMBERSHIP` (beta and alpha only)

#### Removed

* `connectionSchemaIds` query parameter removed from the alpha `listConnectFiles` endpoint (alpha only)