fix(api-keys): rename the update params key to id

[felipefreitag]

What

ApiKeys.update takes params["api_key_id"]; every other update params dict in the SDK uses id:

Domains.update({"id": ...})
Emails.update({"id": ...})
Templates.update({"id": ...})
ContactProperties.update({"id": ...})
ApiKeys.update({"api_key_id": ...})   # the exception

This renames the key to id in the TypedDict, both method bodies, the tests, and both examples, and bumps the version to 2.40.2.

Why a clean rename is safe

The method shipped yesterday (v2.40.0, 2026-08-24). Datadog traces for PATCH /api-keys/:apiKeyId since then show 33 requests; the indexed spans group into two user agents, node and resend-remote-mcp:1.0.0. Zero calls from resend-python. There is nobody to break, so no deprecation alias.

Scope

remove(api_key_id=...) keeps its name: positional id parameters ship in both forms across the SDK (id in audiences/broadcasts/contact_properties, <resource>_id in domains/emails/automations), and its kwarg form is long documented.

Checks

pytest 614 passed; mypy clean; flake8 clean (flake8 7.x locally, CI pins <5).

Follow-up: the Python tab on docs update-api-key.mdx teaches "api_key_id" and needs the same rename when this releases.

[cubic-dev-ai]

No issues found across 5 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Requires human review: Renames the api_key_id parameter to id in the update/update_async methods and public UpdateParams TypedDict, aligning with SDK convention but breaking the v2.40.0 request shape.

Re-trigger cubic</sub>