Repository navigation
Winter '27 (API v68.0) adoption. See ADR-035 and the
upgrade guide for a fix for each breaking change.
Breaking
force
- Default API version is now v68.0 (Winter '27).
MAX_TESTEDis v68.0. JobOperationhas new variantsRefreshandConsentImport. Amatchwithout a_arm must add them.AuthenticationErrorhas a new variantUnsupportedTokenType.CreateJobRequestno longer sends an emptyobject.JobInfo.objectdecodes a missing ornullvalue as"".GraphqlRequestsendsoperationName(wasoperation_name, which the server ignored). Tests that assert the request body must change the key.- A DPoP-bound token (
token_type: DPoP) now fails withAuthenticationError::UnsupportedTokenTypebefore any request, on every path (REST, SOAP, Data Cloud exchange, Pub/Sub). - The SOAP handler returns
InvalidInputwhenapi_versionislatest. SmartIngestreturnsInvalidInputforJobOperation::Refresh. It splits input into many jobs, and each refresh job replaces the data set.- Agent API methods return
InvalidInputfor an agent or session ID with characters other than[A-Za-z0-9_-].
Added
force
ApiVersion::V68,release_name(),LATEST_ALIAS, andis_latest_alias().ClientConfig.api_versionaccepts"latest"for REST resources.- REST:
versions()andhighest_version()for the Versions resource (GET /services/data/), withApiVersionInfo. - Bulk API 2.0:
CreateJobRequest::new,consent_import, andvalidate. - Tooling:
apex_compile_results(),symbols()(Beta),discover_tests(), anddiscover_tests_next(), with a client-sidetestLevel/showAllMethodsversion check. - GraphQL:
lookup_values()foruiapi.lookupValues. - SOQL:
SoqlQueryBuilder::try_where_formula()forFORMULA()(Beta), withFormulaOperator,ComparisonOperator, andFormulaLiteral(also re-exported fromforce::api::rest). - New
api_catalogfeature (infull): MCP server registry handler (client.api_catalog()). - Agent API:
send_message_stream()andsend_text_stream()(Server-Sent Events, 1 MiB per event),with_stream_timeout(),stream_timeout(), andDEFAULT_STREAM_TIMEOUT. AccessToken::is_dpop_bound().
Changed
force
- A per-request timeout (for example the stream timeout) now also sets the executor's time limit for that request.
AgentMessage.resultandcited_referencesacceptnullor one object, not only an array.- Composite treats a
latest/...sub-request URL as already versioned.
Fixed
force
ApiVersionconstant docs had release names one year late (for example v67.0 is Summer '26, not Summer '25).
Security
workspace
- Patched
zstd-safe7.3.0 for RUSTSEC-2026-0403 (vendored backport of the 8.2.0 fix; seevendor/zstd-safe-7.3.0/FORCE-RS-PATCH.md). - Patched
zstd0.13.3 for RUSTSEC-2026-0391 (vendored backport of the 0.14.3 fix; seevendor/zstd-0.13.3/FORCE-RS-PATCH.md).
Documentation
- ADR-035, the Winter '27 adoption plan, the API Catalog surface page, and Winter '27 OAuth notes (refresh-token idle limit, rotation, External Client Apps, DPoP, instanced URLs, username-password retirement on 2027-02-20).