Flowable REST API — CMMN

naftiko: 1.0.0-alpha2
info:
  label: Flowable REST API — CMMN
  description: 'Flowable REST API — CMMN. 5 operations. Lead operation: List CMMN case instances. Self-contained Naftiko capability
    covering one Flowable Api business surface.'
  tags:
  - Flowable Api
  - CMMN
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    FLOWABLE_API_API_KEY: FLOWABLE_API_API_KEY
capability:
  consumes:
  - type: http
    namespace: flowable-cmmn
    baseUri: https://flowable.example.com/flowable-rest/service
    description: Flowable REST API — CMMN business capability. Self-contained, no shared references.
    resources:
    - name: cmmn-runtime-case-instances
      path: /cmmn-runtime/case-instances
      operations:
      - name: listcaseinstances
        method: GET
        description: List CMMN case instances
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: startcaseinstance
        method: POST
        description: Start a CMMN case instance
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: cmmn-runtime-case-instances-caseInstanceId
      path: /cmmn-runtime/case-instances/{caseInstanceId}
      operations:
      - name: deletecaseinstance
        method: DELETE
        description: Delete a CMMN case instance
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: caseInstanceId
          in: path
          type: string
          required: true
    - name: dmn-repository-decision-tables
      path: /dmn-repository/decision-tables
      operations:
      - name: listdecisiontables
        method: GET
        description: List DMN decision tables
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: dmn-rule-execute
      path: /dmn-rule/execute
      operations:
      - name: executedecision
        method: POST
        description: Execute a DMN decision
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: flowable-cmmn-rest
    port: 8080
    description: REST adapter for Flowable REST API — CMMN. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/cmmn-runtime/case-instances
      name: cmmn-runtime-case-instances
      description: REST surface for cmmn-runtime-case-instances.
      operations:
      - method: GET
        name: listcaseinstances
        description: List CMMN case instances
        call: flowable-cmmn.listcaseinstances
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: startcaseinstance
        description: Start a CMMN case instance
        call: flowable-cmmn.startcaseinstance
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cmmn-runtime/case-instances/{caseinstanceid}
      name: cmmn-runtime-case-instances-caseinstanceid
      description: REST surface for cmmn-runtime-case-instances-caseInstanceId.
      operations:
      - method: DELETE
        name: deletecaseinstance
        description: Delete a CMMN case instance
        call: flowable-cmmn.deletecaseinstance
        with:
          caseInstanceId: rest.caseInstanceId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/dmn-repository/decision-tables
      name: dmn-repository-decision-tables
      description: REST surface for dmn-repository-decision-tables.
      operations:
      - method: GET
        name: listdecisiontables
        description: List DMN decision tables
        call: flowable-cmmn.listdecisiontables
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/dmn-rule/execute
      name: dmn-rule-execute
      description: REST surface for dmn-rule-execute.
      operations:
      - method: POST
        name: executedecision
        description: Execute a DMN decision
        call: flowable-cmmn.executedecision
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: flowable-cmmn-mcp
    port: 9090
    transport: http
    description: MCP adapter for Flowable REST API — CMMN. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: list-cmmn-case-instances
      description: List CMMN case instances
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flowable-cmmn.listcaseinstances
      outputParameters:
      - type: object
        mapping: $.
    - name: start-cmmn-case-instance
      description: Start a CMMN case instance
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flowable-cmmn.startcaseinstance
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-cmmn-case-instance
      description: Delete a CMMN case instance
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: flowable-cmmn.deletecaseinstance
      with:
        caseInstanceId: tools.caseInstanceId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-dmn-decision-tables
      description: List DMN decision tables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flowable-cmmn.listdecisiontables
      outputParameters:
      - type: object
        mapping: $.
    - name: execute-dmn-decision
      description: Execute a DMN decision
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flowable-cmmn.executedecision
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.