Temporal Update a Namespace With Optimistic Concurrency

arazzo: 1.0.1
info:
  title: Temporal Update a Namespace With Optimistic Concurrency
  summary: Read a Namespace, update its spec using the current resourceVersion, then confirm the change.
  description: >-
    Temporal Cloud Namespace updates use optimistic concurrency: the caller must
    supply the resourceVersion read from the live Namespace. This workflow reads
    the Namespace, submits an update carrying that resourceVersion plus the new
    spec, then re-reads the Namespace to confirm the resourceVersion advanced.
    Every step spells out its request inline so the flow can be read and executed
    without opening the underlying OpenAPI description.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-4230.10
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-4230.10
      capability_name: Tenant Provisioning & Lifecycle
      spec: temporal-namespaces-api-openapi.yml
      confidence: 0.7
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: namespacesApi
  url: ../openapi/temporal-namespaces-api-openapi.yml
  type: openapi
workflows:
- workflowId: update-namespace
  summary: Safely update a Namespace spec using its current resourceVersion.
  description: >-
    Chains getNamespace to capture the current resourceVersion, updateNamespace
    to apply the new spec under that version, and a final getNamespace to verify
    the update was accepted.
  inputs:
    type: object
    required:
    - bearerToken
    - namespace
    - spec
    properties:
      bearerToken:
        type: string
        description: API key used as the Bearer token for Authorization.
      namespace:
        type: string
        description: The Namespace identifier to update.
      spec:
        type: object
        description: The full replacement Namespace spec object.
  steps:
  - stepId: readNamespace
    description: >-
      Read the Namespace to capture its current resourceVersion, required to
      perform an optimistic-concurrency update.
    operationId: getNamespace
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.bearerToken"
    - name: namespace
      in: path
      value: $inputs.namespace
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      resourceVersion: $response.body#/resourceVersion
      currentState: $response.body#/state
  - stepId: applyUpdate
    description: >-
      Submit the new spec carrying the resourceVersion just read so the control
      plane can reject the change if the Namespace was modified concurrently.
    operationId: updateNamespace
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.bearerToken"
    - name: namespace
      in: path
      value: $inputs.namespace
    requestBody:
      contentType: application/json
      payload:
        resourceVersion: $steps.readNamespace.outputs.resourceVersion
        spec: $inputs.spec
    successCriteria:
    - condition: $statusCode == 200
  - stepId: confirmUpdate
    description: >-
      Re-read the Namespace to confirm the update was applied and surface the new
      resourceVersion.
    operationId: getNamespace
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.bearerToken"
    - name: namespace
      in: path
      value: $inputs.namespace
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      newResourceVersion: $response.body#/resourceVersion
      state: $response.body#/state
  outputs:
    previousResourceVersion: $steps.readNamespace.outputs.resourceVersion
    newResourceVersion: $steps.confirmUpdate.outputs.newResourceVersion
    state: $steps.confirmUpdate.outputs.state