Skip to content

Kontent.Ai.Management 9.0.0

Choose a tag to compare

@github-actions github-actions released this 16 Sep 15:37
· 105 commits to main since this release

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, KontentElementAttribute and KontentEnumValueAttribute are now
    ContentTypeAttribute, ContentElementAttribute and ContentOptionAttribute — 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 the 9.0.0 prereleases, so
    8.x has nothing to rename. Regenerate with model generator 11.0.0 or newer, which emits the new
    names.

Added

  • TuneRetry adjusts default retries without replacing the pipeline.

    IManagementClientBuilder.TuneRetry receives initialized retry options, so changing the attempt count preserves the SDK's retry predicates and Retry-After handling. Callbacks run in registration order; ConfigureResilience still 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 under docs/.
    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, and CreateContentItemWithVariantAsync does 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 advised AddManagementClient("Default", ...) - a call that registers an ordinary named client and then collides with the unnamed registration. It now says to call AddManagementClient(...) 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.0

Full changelog: src/management/CHANGELOG.md