Cflow API — Requests

naftiko: 1.0.0-alpha2
info:
  label: Cflow API — Requests
  description: 'Cflow API — Requests. 8 operations. Lead operation: Cflow Create Draft Request. Self-contained Naftiko capability
    covering one Cflow business surface.'
  tags:
  - Cflow
  - Requests
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CFLOW_API_KEY: CFLOW_API_KEY
capability:
  consumes:
  - type: http
    namespace: cflow-requests
    baseUri: https://us.cflowapps.com
    description: Cflow API — Requests business capability. Self-contained, no shared references.
    resources:
    - name: integromat-api-cflow-workflows-workflowId-drafts
      path: /integromat/api/cflow/workflows/{workflowId}/drafts
      operations:
      - name: createdraftrequest
        method: POST
        description: Cflow Create Draft Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: integromat-api-cflow-workflows-workflowId-requests
      path: /integromat/api/cflow/workflows/{workflowId}/requests
      operations:
      - name: listrequests
        method: GET
        description: Cflow List Requests
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
      - name: createrequest
        method: POST
        description: Cflow Create Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: integromat-api-cflow-workflows-workflowId-requests-requestId
      path: /integromat/api/cflow/workflows/{workflowId}/requests/{requestId}
      operations:
      - name: getrequest
        method: GET
        description: Cflow Get Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
        - name: requestId
          in: path
          type: string
          description: The unique identifier of the request.
          required: true
      - name: updaterequest
        method: PUT
        description: Cflow Update Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
        - name: requestId
          in: path
          type: string
          description: The unique identifier of the request.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleterequest
        method: DELETE
        description: Cflow Delete Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
        - name: requestId
          in: path
          type: string
          description: The unique identifier of the request.
          required: true
    - name: integromat-api-cflow-workflows-workflowId-requests-requestId-approve
      path: /integromat/api/cflow/workflows/{workflowId}/requests/{requestId}/approve
      operations:
      - name: approverequest
        method: POST
        description: Cflow Approve Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
        - name: requestId
          in: path
          type: string
          description: The unique identifier of the request.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: integromat-api-cflow-workflows-workflowId-requests-requestId-reject
      path: /integromat/api/cflow/workflows/{workflowId}/requests/{requestId}/reject
      operations:
      - name: rejectrequest
        method: POST
        description: Cflow Reject Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: workflowId
          in: path
          type: string
          description: The unique identifier of the workflow.
          required: true
        - name: requestId
          in: path
          type: string
          description: The unique identifier of the request.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: apikey
      key: apikey
      value: '{{env.CFLOW_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: cflow-requests-rest
    port: 8080
    description: REST adapter for Cflow API — Requests. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/integromat/api/cflow/workflows/{workflowid}/drafts
      name: integromat-api-cflow-workflows-workflowid-drafts
      description: REST surface for integromat-api-cflow-workflows-workflowId-drafts.
      operations:
      - method: POST
        name: createdraftrequest
        description: Cflow Create Draft Request
        call: cflow-requests.createdraftrequest
        with:
          workflowId: rest.workflowId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/integromat/api/cflow/workflows/{workflowid}/requests
      name: integromat-api-cflow-workflows-workflowid-requests
      description: REST surface for integromat-api-cflow-workflows-workflowId-requests.
      operations:
      - method: GET
        name: listrequests
        description: Cflow List Requests
        call: cflow-requests.listrequests
        with:
          workflowId: rest.workflowId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createrequest
        description: Cflow Create Request
        call: cflow-requests.createrequest
        with:
          workflowId: rest.workflowId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/integromat/api/cflow/workflows/{workflowid}/requests/{requestid}
      name: integromat-api-cflow-workflows-workflowid-requests-requestid
      description: REST surface for integromat-api-cflow-workflows-workflowId-requests-requestId.
      operations:
      - method: GET
        name: getrequest
        description: Cflow Get Request
        call: cflow-requests.getrequest
        with:
          workflowId: rest.workflowId
          requestId: rest.requestId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updaterequest
        description: Cflow Update Request
        call: cflow-requests.updaterequest
        with:
          workflowId: rest.workflowId
          requestId: rest.requestId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleterequest
        description: Cflow Delete Request
        call: cflow-requests.deleterequest
        with:
          workflowId: rest.workflowId
          requestId: rest.requestId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/integromat/api/cflow/workflows/{workflowid}/requests/{requestid}/approve
      name: integromat-api-cflow-workflows-workflowid-requests-requestid-approve
      description: REST surface for integromat-api-cflow-workflows-workflowId-requests-requestId-approve.
      operations:
      - method: POST
        name: approverequest
        description: Cflow Approve Request
        call: cflow-requests.approverequest
        with:
          workflowId: rest.workflowId
          requestId: rest.requestId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/integromat/api/cflow/workflows/{workflowid}/requests/{requestid}/reject
      name: integromat-api-cflow-workflows-workflowid-requests-requestid-reject
      description: REST surface for integromat-api-cflow-workflows-workflowId-requests-requestId-reject.
      operations:
      - method: POST
        name: rejectrequest
        description: Cflow Reject Request
        call: cflow-requests.rejectrequest
        with:
          workflowId: rest.workflowId
          requestId: rest.requestId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cflow-requests-mcp
    port: 9090
    transport: http
    description: MCP adapter for Cflow API — Requests. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: cflow-create-draft-request
      description: Cflow Create Draft Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cflow-requests.createdraftrequest
      with:
        workflowId: tools.workflowId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cflow-list-requests
      description: Cflow List Requests
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cflow-requests.listrequests
      with:
        workflowId: tools.workflowId
      outputParameters:
      - type: object
        mapping: $.
    - name: cflow-create-request
      description: Cflow Create Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cflow-requests.createrequest
      with:
        workflowId: tools.workflowId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cflow-get-request
      description: Cflow Get Request
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cflow-requests.getrequest
      with:
        workflowId: tools.workflowId
        requestId: tools.requestId
      outputParameters:
      - type: object
        mapping: $.
    - name: cflow-update-request
      description: Cflow Update Request
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: cflow-requests.updaterequest
      with:
        workflowId: tools.workflowId
        requestId: tools.requestId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cflow-delete-request
      description: Cflow Delete Request
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: cflow-requests.deleterequest
      with:
        workflowId: tools.workflowId
        requestId: tools.requestId
      outputParameters:
      - type: object
        mapping: $.
    - name: cflow-approve-request
      description: Cflow Approve Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cflow-requests.approverequest
      with:
        workflowId: tools.workflowId
        requestId: tools.requestId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cflow-reject-request
      description: Cflow Reject Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cflow-requests.rejectrequest
      with:
        workflowId: tools.workflowId
        requestId: tools.requestId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.