Skip to content

v10.0.0

Latest

Choose a tag to compare

@camunda-sdk-automation camunda-sdk-automation released this 14 Oct 01:06
· 51 commits to main since this release
b014791

10.0.0 (2026-10-14)

  • feat!: advance main to the 10.x alpha line (Camunda 8.10) (e607354)

Bug Fixes

  • add docs badge for Nuget package page (68dd191)
  • add GroupId to CreateGroupRequest example (8e6b004)
  • add IAsyncDisposable, diagnostic logging, and 30 new tests (0b1a497)
  • add missing overwrite entries and examples (green) (f498d85), closes #78
  • add technical preview note (5bb497e)
  • add validation gate for overwrite example resolution (09cb254)
  • address PR review comments (6efa8b4)
  • address PR review comments (fc2b910)
  • address PR review comments (4c0f313)
  • address review comments on TLS handler (20d778a)
  • adopt upstream wait-state details union to unblock main build (fb63984)
  • adopt upstream wait-state details union to unblock main build (aac1aac)
  • align config defaults with JS SDK for zero-config SaaS support (b49146c)
  • always throw on non-2xx HTTP responses (36b0135)
  • build for latest stable/8.9 (be406c4)
  • build from stable/8.9 (bc5b929)
  • build from stable/8.9 (45033a1)
  • ci: put the branch in the prompt and catch untracked leftovers (#371) (1b2d21f)
  • ci: tell the agent which commands actually gate its work (#372) (5f4d516)
  • config: fold only array-shaped IConfiguration sections (#379) (5d75944), closes #377 #378
  • correctly handle nullables (fbf130c)
  • deprecate some enum members (f9626ca)
  • deps: bump camunda-schema-bundler to 2.4.3 (197c422)
  • deps: bump camunda-schema-bundler to 2.4.3 (1696cff)
  • disable successComment to avoid GraphQL error on non-PR commits (77de048)
  • examples: group plannedChanges by physical tenant and cover new operations (#392) (deda1ad)
  • examples: pass Mode enum to ChangeClusterModeAsync (8dc5bc4)
  • flatten allOf composition transitively in the generator (3f9fd6b), closes #265
  • flatten CamundaClient TOC in API docs to alphabetical list (c086bcd)
  • gen: apply CAMUNDA_DEFAULT_TENANT_ID to ActivateJobsAsync tenantIds (#123) (b6536ff)
  • gen: count operation body/response refs when detecting orphan bases (3449014)
  • gen: enforce oneOf semantics in advanced-filter converters (b6eb9bf)
  • generator: sanitize spec-controlled strings against Unicode injection (#116) (705b472)
  • gen: only suppress true discriminator-only union bases (ee51d7f)
  • gen: regenerate artifacts (e1b0f5e)
  • gen: regenerate artifacts (3f64c74)
  • gen: regenerate artifacts (b60ec93)
  • gen: regenerate artifacts (d3596f7)
  • gen: regenerate artifacts (0e956cb)
  • gen: regenerate artifacts (7884093)
  • gen: regenerate artifacts (09edf9b)
  • gen: regenerate artifacts (bf4d28a)
  • gen: regenerate artifacts (28fb16b)
  • gen: regenerate artifacts (ba708c0)
  • gen: regenerate artifacts (eecaa06)
  • gen: regenerate artifacts (f248e56)
  • gen: regenerate artifacts (8d9b85a)
  • gen: regenerate artifacts (76c4614)
  • gen: regenerate artifacts (fdd209c)
  • gen: regenerate artifacts (6b06ee4)
  • gen: regenerate artifacts (d23f0cf)
  • gen: regenerate artifacts (8da4ae8)
  • gen: regenerate artifacts (d8f54bc)
  • gen: regenerate artifacts (de541d3)
  • gen: regenerate artifacts (de9b79f)
  • gen: regenerate artifacts (140b000)
  • gen: regenerate artifacts (d3764d0)
  • gen: regenerate artifacts (0e01fdd)
  • gen: regenerate artifacts (877832b)
  • gen: regenerate artifacts (30433b1)
  • gen: regenerate artifacts (ce960bb)
  • gen: regenerate artifacts (2b5d47a)
  • gen: regenerate artifacts (75e13b1)
  • gen: regenerate artifacts (a0ea912)
  • gen: regenerate artifacts (6a4276e)
  • gen: regenerate artifacts (341f8e2)
  • gen: regenerate artifacts (05eebb6)
  • gen: regenerate artifacts (e5444ee)
  • gen: regenerate artifacts (948eb10)
  • gen: regenerate artifacts (4e514ca)
  • gen: regenerate artifacts (85f9b10)
  • gen: regenerate artifacts (77e8755)
  • gen: regenerate artifacts (1e282c3)
  • gen: regenerate artifacts (3dcb2e4)
  • gen: regenerate artifacts (671da1b)
  • gen: regenerate artifacts (9606881)
  • gen: regenerate artifacts (3a98fb1)
  • gen: regenerate artifacts (0e75716)
  • gen: regenerate artifacts (2137ad1)
  • gen: regenerate artifacts (7d1f8fc)
  • gen: regenerate artifacts [skip ci] (d199286)
  • gen: regenerate artifacts [skip ci] (1956934)
  • gen: regenerate artifacts [skip ci] (fc8e59e)
  • gen: regenerate artifacts [skip ci] (b9f67f1)
  • gen: regenerate artifacts [skip ci] (c649e38)
  • gen: regenerate artifacts [skip ci] (393b5f8)
  • gen: regenerate artifacts [skip ci] (2074522)
  • gen: regenerate SDK from stable/8.9 spec with unified namespace (7ff87b8)
  • gen: suppress discriminator-only oneOf union base types (5278690)
  • gen: suppress discriminator-only oneOf union base types (ba5d18e), closes #255
  • gen: surface the exact-match branch of advanced-filter oneOf properties (aee2094), closes #267
  • group document operations together in operation-map (874a5c6)
  • handle YAML value tag in DocFX output (9aecbad)
  • harden README code injection (6965ad6), closes #36
  • harden release pipeline against unreviewed file staging (e518c39)
  • inject default tenant ID for multipart createDeployment (f24e052), closes #40
  • make build warnings fatal, suppress known example warnings (2513561), closes #49
  • map bare type:object schemas to object instead of empty class (9eb35d6)
  • map bare type:object schemas to object instead of empty class (2512e09)
  • materialize inline schemas as full types (1fd9711)
  • moved Camunda class func to CamundaClient to prevent namespace issues (cc260d6)
  • pass author-association to community notification workflow (e633de5)
  • point docs-md generator at correct examples directory (bb3c9de)
  • Potential fix for pull request finding (b3f6353)
  • prefer DeployResourcesFromFiles in API spec examples (965e492)
  • regenerate SDK for agent-instance spec drift breaking main (#409) (4daa4c1)
  • release: retry semantic-release in place on push-race failure (#423) (7c08366)
  • remove unused Polly dependency (b60ad0f)
  • rename package (a9f4a4f)
  • resolve $ref schemas for binary detection and add SendBinaryAsync tests (f8b0af8)
  • resolve key constraints through nested allOf in the generator (f493e30)
  • resolve PR review comments - add XML region tags, compile examples, fix types (4e3136c), closes #region
  • return byte[] for binary (octet-stream) response operations (586a926)
  • return byte[] for binary (octet-stream) response operations (e5aaaa2)
  • sanitize remaining spec-controlled strings in generator output (e1bbe6d)
  • sanitize remaining spec-controlled strings in generator output (6e9ba17), closes camunda/security-testing-findings#65
  • separate code blocks per example in IntelliSense remarks (397c2b4)
  • serialize query and path params with invariant ISO 8601 format (#434) (f66e30e), closes #433
  • shorten discriminant labels for multi-entry operations (e7b0ec2)
  • skip discriminator property on derived types for .NET 10 compat (d8d1495), closes #38
  • sort required query params before optional in generator (b88b5cf), closes #62
  • test: stop EngineTimeProviderTests timer-cancellation test racing a fixed 150ms window (#424) (173f019)
  • update examples to use branded type parameters (47a7d1a)
  • update release process (d559644)
  • update release process documentation (eafeb4d)
  • use camunda-schema-bundler 1.3.3. contains breaking type changes (6359740)
  • use git add -f for gitignored spec artifacts in release (d12cddf)
  • use git add -f for gitignored spec artifacts in release (58381f6)
  • widen integer-backed branded structs to long for ICamundaLongKey contract (73f42ca)

chore

  • gen: signal breaking API surface changes from spec refresh (781e7b8)

Features

  • add example coverage for getAgentDefinition, searchAgentDefinitions (#389) (d653b61)
  • add example coverage for getClusterExportingStatus, pauseClusterExporting, resumeClusterExporting, takeHistoryBackupAsClusterAdmin, listHistoryBackupsAsClusterAdmin, getHistoryBackupAsClusterAdmin, deleteHistoryBackupAsClusterAdmin (#400) (c2c4e3e)
  • add example coverage for getClusterStatus, getRestoreStatus (#366) (6932b89)
  • add example coverage for getClusterUpgradeStatus (#444) (e6d9e41)
  • add example coverage for getExportingStatus (#370) (cfd507e)
  • add example coverage for getProcessInstanceWaitStateStatistics (5bf77d3), closes #291
  • add example coverage for listSecrets (9635b87)
  • add example coverage for restoreAsClusterAdmin, getClusterTopology (#395) (48045db)
  • add example coverage for searchOwnAuthorizations (#382) (9df2888)
  • add example coverage for takeRuntimeBackupAsClusterAdmin, listRuntimeBackupsAsClusterAdmin, getRuntimeBackupStateAsClusterAdmin, deleteRuntimeBackupStateAsClusterAdmin, syncRuntimeBackupStateAsClusterAdmin, getRuntimeBackupAsClusterAdmin, deleteRuntimeBackupAsClusterAdmin (#404) (3f0996b), closes #403
  • add example coverage for triggerClusterRebalance, getClusterRebalance, cancelClusterRebalance (#406) (a10eb28), closes #405
  • add examples for getAgentInstance and searchAgentInstances (4aadc17)
  • add idiomatic .NET config mechanisms (ef9192c)
  • add imports field to operation-map entries (afcc895)
  • add Roslyn-based API changelog tool (d68fb52)
  • add SDK examples for new operations (824564d)
  • add SearchVariablesAsDtoAsync for typed variable maps (31c96ca)
  • add SearchVariablesAsDtoAsync for typed variable maps (d8f8e2b)
  • add Slack notifications for release failures and community events (d945e1c)
  • add Slack notifications for release failures and community events (b5b8a10)
  • add startup jitter to worker creation (41b26aa)
  • add updateJobsBatchOperation endpoint (c52fcec)
  • add updateJobsBatchOperation endpoint and example coverage (9abc999)
  • begin SDK 10 development for Camunda server 8.10 (5f61d22)
  • bind SDK cadence to the engine clock with EngineTimeProvider (#419) (7ab335d), closes #402 #450 #450 #412 #450
  • build from latest stable/8.9 (87fd01f)
  • build from latest stable/8.9 (786b090)
  • draw runtime jitter from an injected, seedable IRandomSource (#455) (6a22f88), closes camunda/sdk-infra#50 #pragma
  • embed specHash from spec-metadata.json in published package (0db4ba5), closes #39
  • emit JsonPolymorphic discriminator attributes for oneOf schemas (b89bbf4)
  • generate FilterProperty classes with advanced filter properties (009b6df)
  • generate implicit conversions and equality for union semantic key types (fd0f0c8)
  • generate typed enums for inline string enum properties (6721d7d)
  • generate typed enums for inline string enum properties (69d7086), closes #171
  • gen: surface referencedSecrets on expression evaluation results (#398) (3a8c427)
  • heritable worker defaults via CAMUNDA_WORKER_* env vars (3233cd7)
  • honor job leases across worker complete, fail, and throw-error (#447) (a0cfa92), closes camunda/camunda#62777 #437
  • include code examples in remarks for IntelliSense (0039de7)
  • inject code examples into generated SDK method XML docs (740522b), closes #53
  • opt out of automatic /v2 suffix via CAMUNDA_REST_ADDRESS_EXACT (#451) (367616a), closes #430 #122 #122
  • regenerate SDK for condition wait-state (upstream main sync) (287b3d0)
  • regenerate SDK for job priority-updated state and timer/signal wait-states (6e4e1d7)
  • regenerate SDK for upstream main spec sync (912e45e)
  • regenerate SDK for upstream main spec sync (77e5dd2)
  • regenerate SDK for upstream wait-state details and job priority-updated state (3dddcaa)
  • release SDK 9 for Camunda server 8.9 (2008077)
  • resolve SDK runtime cadence and handler-facing time through an injected TimeProvider (#412) (3406d54), closes camunda/orchestration-cluster-api-js#450 camunda/orchestration-cluster-api-csharp#402 #pragma hi#water hi#water camunda/sdk-infra#50 #450
  • segment README into per-section Docusaurus pages (8155e96), closes #9
  • support custom TLS certificates (self-signed CA & mTLS) (617f856), closes #54
  • support deprecated enum members (a73006a)
  • support job corrections and denial in worker handlers (f19a8bf)
  • upgrade bundler to 2.4.1 and update default spec ref to main (86ad8c6)
  • worker: support TenantFilter and CAMUNDA_TENANT_IDS in job workers (#377) (47e354e), closes #376 #122
  • worker: support TenantIds and TenantId on JobWorkerConfig (f34852b)
  • worker: support TenantIds and TenantId on JobWorkerConfig (bf24581), closes #120

BREAKING CHANGES

  • gen: Iteration renamed to LoopIteration (struct IterationId removed,
    LoopIterationId added; JSON wire field 'iteration' -> 'loopIteration').
    JobStateEnum adds TIMEOUTUPDATED (=8, wire 'TIMEOUT_UPDATED'). ActivatedJobResult
    adds new properties.
  • main now publishes the 10.x alpha line targeting Camunda
    8.10. Consumers on the main/alpha channel move from 9.0.0-alpha.N to
    10.0.0-alpha.N; pin to the 9.x line to stay on Camunda 8.9.

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

  • SDK major version bumped from 9 to 10
  • SDK major version bumped from 8 to 9 to track Camunda server 8.9