Reducto Extract API — Extract

naftiko: 1.0.0-alpha2
info:
  label: Reducto Extract API — Extract
  description: 'Reducto Extract API — Extract. 2 operations covering synchronous and asynchronous extract.
    Self-contained Naftiko capability for the Reducto Extract business surface, supporting schema-driven
    structured-data extraction with deep extract, array extraction, and citations.'
  tags:
  - Reducto
  - Extract
  - Document AI
  - Structured Data
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    REDUCTO_API_KEY: REDUCTO_API_KEY
capability:
  consumes:
  - type: http
    namespace: extract-extract
    baseUri: https://platform.reducto.ai
    description: Reducto Extract API — Extract business capability. Self-contained, no shared references.
    resources:
    - name: extract
      path: /extract
      operations:
      - name: extractstructureddata
        method: POST
        description: Reducto Extract Structured Data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: extract-async
      path: /extract_async
      operations:
      - name: extractstructureddataasync
        method: POST
        description: Reducto Extract Structured Data Async
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: bearer
      value: '{{env.REDUCTO_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: extract-extract-rest
    port: 8080
    description: REST adapter for Reducto Extract API — Extract.
    resources:
    - path: /v1/extract
      name: extract
      operations:
      - method: POST
        name: extractstructureddata
        call: extract-extract.extractstructureddata
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/extract_async
      name: extract-async
      operations:
      - method: POST
        name: extractstructureddataasync
        call: extract-extract.extractstructureddataasync
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: extract-extract-mcp
    port: 9090
    transport: http
    description: MCP adapter for Reducto Extract API — Extract.
    tools:
    - name: reducto-extract
      description: Reducto Extract Structured Data
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: extract-extract.extractstructureddata
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: reducto-extract-async
      description: Reducto Extract Structured Data Async
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: extract-extract.extractstructureddataasync
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.