Repository navigation
Kontent.Ai.Management 9.0.0
The first stable release of the 9.x line, and the GA of the modernization the 9.0.0-beta and
9.0.0-rc series delivered. Targets net10.0.
Coming from 8.x, the shape of the API changed throughout: calls return an IManagementResult
instead of throwing, listings come back materialized rather than paged by hand, serialization moved to
System.Text.Json, strongly-typed models are immutable records, and registration is one builder.
Retries are idempotency-aware — a 429 is retried for every method, other transient failures only for
idempotent ones — so a POST that fails mid-flight is never replayed.
Full migration: 8 → 9.
The sections below list what changed since 9.0.0-rc.3; the beta and rc entries further down
record the rest of the line.
Breaking changes
-
The model attributes are renamed to content-model terminology.
KontentTypeAttribute,KontentElementAttributeandKontentEnumValueAttributeare now
ContentTypeAttribute,ContentElementAttributeandContentOptionAttribute— the API's own words
for a content type, an element, and a multiple-choice option. The old names are gone, so a generated
model carrying them no longer compiles. They have only ever shipped in the9.0.0prereleases, so
8.x has nothing to rename. Regenerate with model generator11.0.0or newer, which emits the new
names.
Added
-
TuneRetryadjusts default retries without replacing the pipeline.IManagementClientBuilder.TuneRetryreceives initialized retry options, so changing the attempt count preserves the SDK's retry predicates andRetry-Afterhandling. Callbacks run in registration order;ConfigureResiliencestill replaces the pipeline and bypasses tuning.
Changed
-
The README is a routing page; its reference material moved into seven guides.
993 lines became 117, with configuration, requests and results, content items and variants, models
and rich text, assets, content model, and administration each owning one topic underdocs/.
Inbound links inside the repository were updated, including the 8 to 9 upgrade guide's. Four README
anchors are unchanged; the rest moved, and each maps to a new guide section. Two contract corrections
came with the move: an upsert omits an element because its property value is null rather than because
the SDK tracks what you assigned, andCreateContentItemWithVariantAsyncdoes not resume a previous
partial failure - it attempts another create, so recover by reconciling the existing item and retrying
the variant step.
Fixed
-
A missing default client no longer reports the internal
'Default'name.IManagementClientFactory.Get()resolves the client registered without a name, which the SDK files under an internal key. When none was registered the error named that key and advisedAddManagementClient("Default", ...)- a call that registers an ordinary named client and then collides with the unnamed registration. It now says to callAddManagementClient(...)without a name. Registering the default twice reports it as a default rather than as a name clash. Errors for explicitly named clients are unchanged.
Installation
dotnet add package Kontent.Ai.Management --version 9.0.0Full changelog: src/management/CHANGELOG.md