Swift changelog
Release notes for K9OGate, from the CHANGELOG.md in the sdk-swift repository. Read on 17 November 2026 at 15:55 UTC.
1.5.2
Changed
- README: Architecture at a glance, illustrations, and the package table lists only the packages for that SDK.
1.5.0
Fixed
- Calls made against the short address (
https://<org>.api.k9o.io) no longer fail with 400K9O_INVALID_REQUEST_SHAPE, so sign-in, refresh and sign-out work with it. The client learns your region once with a request that carries no credentials, then sends every call to the regional host. A regional address is used as given.
Added
- The end-user flows beyond password sign-in, as the wire layer:
passkeys.register.beginandfinish,passkeys.signIn.beginandfinish,mfa.totp.enrollandconfirm,mfa.methods.list(bearerToken:)andmfa.methods.delete(methodId:code:bearerToken:),passwordReset.requestandredeem,invitations.redeem, andverifySession(token:bearerToken:). The passkey calls carry WebAuthn options and credentials asK9OJSONand do not call the platform's passkey API. orgSlugonGateClient:try GateClient(orgSlug: "acme", projectSlug: ...)useshttps://acme.api.k9o.io, andorgBaseURLbecomes optional alongside it. A full organization address or a custom domain is used as given. With neither, construction throwsK9OGateConfigError.invalidBaseURL; a malformed slug throwsK9OGateConfigError.invalidFieldValue.K9OGateConfigErrorexposescode(K9O_INVALID_BASE_URLorK9O_INVALID_FIELD_VALUE),messageandcontext(["field": "baseUrl"]or["field": "orgSlug", "slug": ...]).signInfirst asks the project which region holds the email (one extra request with only the email) and sends the password to that region's host, if it is a region host of your own organization and apex; otherwise to the base URL. If the project's locate step answers 404, the client uses the base address.refreshTokenandsignOutgo to the region that issued the session.K9OGateError.rateLimitedandK9OGateError.regionUnavailable, thrown when that step answers429or503. Nothing is retried and no password is sent.probeTransportoption onGateClientfor the region request.K9OGateErroraccessorscode(theK9O_*wire code, including codes the SDK does not name),recommendation,retryAfterSec,requestId,statusCodeandpublicMessage(a fixed sentence by status class, safe to show to users).requestIdis the value of thex-k9o-request-idresponse header; the cases that come from a gateway response carry it as an associated value (requestId: String?), so.unauthenticated,.forbidden,.invalidCredentials,.rateLimited,.regionUnavailableand.unknownnow take arequestIdpayload. This is a source-breaking change to pattern matches on those cases.errorsoption onGateClient, aK9OGateErrorMode:.full(default) or.redacted, which drops an unknown code, its body and its recommendation, and keeps the status and any retry wait.
1.4.0 — 2026-10-26
Changed
- README description.
1.3.0 — 2026-10-26
Changed
refreshToken(refreshToken:)takes only the refresh token and returns aK9ORefreshResultwithaccessTokenandexpiresAt.refreshTokenno longer replaces the stored refresh token. The gateway does not rotate it.signOut(refreshToken:)returns aBool:truewhen a live session was revoked.customClaimsreturns the flatext.<namespace>.<name>keys of the token.- Response fields are read as the gateway sends them (camelCase).
Removed
- The
projectHintargument ofrefreshToken. The gateway rejects it.
Added
K9ORefreshResult.K9OAccessToken.customClaim(namespace:name:)reads one custom claim.
1.2.0 — 2026-10-25
- The README now introduces the Kilimanjaro building blocks (Keep, Pulse, Gate, Kibo). No change to the public API.
1.1.1 — 2026-10-25
- Documentation links corrected: the documentation hub is https://docs.kilimanjaro.dev, with the website, platform API and console listed in a Links section. Package metadata points at the same places.
1.1.0 — 2026-10-25
- Documentation rewritten with runnable examples and expected output; internal cross-references removed from the published sources. No change to the public API.
1.0.0 — 2026-10-23
First public release. See the README for the full API overview.