helicone-api — Request

naftiko: 1.0.0-alpha2
info:
  label: helicone-api — Request
  description: 'helicone-api — Request. 10 operations. Lead operation: Request. Self-contained Naftiko capability covering
    one Helicone business surface.'
  tags:
  - Helicone
  - Request
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    HELICONE_API_KEY: HELICONE_API_KEY
capability:
  consumes:
  - type: http
    namespace: helicone-request
    baseUri: https://api.helicone.ai
    description: helicone-api — Request business capability. Self-contained, no shared references.
    resources:
    - name: v1-request-count-query
      path: /v1/request/count/query
      operations:
      - name: getrequestcount
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-request-query
      path: /v1/request/query
      operations:
      - name: getrequests
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-request-query-clickhouse
      path: /v1/request/query-clickhouse
      operations:
      - name: getrequestsclickhouse
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-request-query-ids
      path: /v1/request/query-ids
      operations:
      - name: getrequestsbyids
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-request-requestId
      path: /v1/request/{requestId}
      operations:
      - name: getrequestbyid
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requestId
          in: path
          type: string
          required: true
        - name: includeBody
          in: query
          type: boolean
    - name: v1-request-requestId-assets-assetId
      path: /v1/request/{requestId}/assets/{assetId}
      operations:
      - name: getrequestassetbyid
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requestId
          in: path
          type: string
          required: true
        - name: assetId
          in: path
          type: string
          required: true
    - name: v1-request-requestId-feedback
      path: /v1/request/{requestId}/feedback
      operations:
      - name: feedbackrequest
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requestId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-request-requestId-inputs
      path: /v1/request/{requestId}/inputs
      operations:
      - name: getrequestinputs
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requestId
          in: path
          type: string
          required: true
    - name: v1-request-requestId-property
      path: /v1/request/{requestId}/property
      operations:
      - name: putproperty
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requestId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-request-requestId-score
      path: /v1/request/{requestId}/score
      operations:
      - name: addscores
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requestId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.HELICONE_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: helicone-request-rest
    port: 8080
    description: REST adapter for helicone-api — Request. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/v1/request/count/query
      name: v1-request-count-query
      description: REST surface for v1-request-count-query.
      operations:
      - method: POST
        name: getrequestcount
        description: getrequestcount
        call: helicone-request.getrequestcount
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/query
      name: v1-request-query
      description: REST surface for v1-request-query.
      operations:
      - method: POST
        name: getrequests
        description: getrequests
        call: helicone-request.getrequests
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/query-clickhouse
      name: v1-request-query-clickhouse
      description: REST surface for v1-request-query-clickhouse.
      operations:
      - method: POST
        name: getrequestsclickhouse
        description: getrequestsclickhouse
        call: helicone-request.getrequestsclickhouse
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/query-ids
      name: v1-request-query-ids
      description: REST surface for v1-request-query-ids.
      operations:
      - method: POST
        name: getrequestsbyids
        description: getrequestsbyids
        call: helicone-request.getrequestsbyids
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/{requestid}
      name: v1-request-requestid
      description: REST surface for v1-request-requestId.
      operations:
      - method: GET
        name: getrequestbyid
        description: getrequestbyid
        call: helicone-request.getrequestbyid
        with:
          requestId: rest.requestId
          includeBody: rest.includeBody
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/{requestid}/assets/{assetid}
      name: v1-request-requestid-assets-assetid
      description: REST surface for v1-request-requestId-assets-assetId.
      operations:
      - method: POST
        name: getrequestassetbyid
        description: getrequestassetbyid
        call: helicone-request.getrequestassetbyid
        with:
          requestId: rest.requestId
          assetId: rest.assetId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/{requestid}/feedback
      name: v1-request-requestid-feedback
      description: REST surface for v1-request-requestId-feedback.
      operations:
      - method: POST
        name: feedbackrequest
        description: feedbackrequest
        call: helicone-request.feedbackrequest
        with:
          requestId: rest.requestId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/{requestid}/inputs
      name: v1-request-requestid-inputs
      description: REST surface for v1-request-requestId-inputs.
      operations:
      - method: GET
        name: getrequestinputs
        description: getrequestinputs
        call: helicone-request.getrequestinputs
        with:
          requestId: rest.requestId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/{requestid}/property
      name: v1-request-requestid-property
      description: REST surface for v1-request-requestId-property.
      operations:
      - method: PUT
        name: putproperty
        description: putproperty
        call: helicone-request.putproperty
        with:
          requestId: rest.requestId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/request/{requestid}/score
      name: v1-request-requestid-score
      description: REST surface for v1-request-requestId-score.
      operations:
      - method: POST
        name: addscores
        description: addscores
        call: helicone-request.addscores
        with:
          requestId: rest.requestId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: helicone-request-mcp
    port: 9090
    transport: http
    description: MCP adapter for helicone-api — Request. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: getrequestcount
      description: getrequestcount
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-request.getrequestcount
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getrequests
      description: getrequests
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-request.getrequests
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getrequestsclickhouse
      description: getrequestsclickhouse
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-request.getrequestsclickhouse
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getrequestsbyids
      description: getrequestsbyids
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-request.getrequestsbyids
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getrequestbyid
      description: getrequestbyid
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-request.getrequestbyid
      with:
        requestId: tools.requestId
        includeBody: tools.includeBody
      outputParameters:
      - type: object
        mapping: $.
    - name: getrequestassetbyid
      description: getrequestassetbyid
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-request.getrequestassetbyid
      with:
        requestId: tools.requestId
        assetId: tools.assetId
      outputParameters:
      - type: object
        mapping: $.
    - name: feedbackrequest
      description: feedbackrequest
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-request.feedbackrequest
      with:
        requestId: tools.requestId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getrequestinputs
      description: getrequestinputs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-request.getrequestinputs
      with:
        requestId: tools.requestId
      outputParameters:
      - type: object
        mapping: $.
    - name: putproperty
      description: putproperty
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: helicone-request.putproperty
      with:
        requestId: tools.requestId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: addscores
      description: addscores
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-request.addscores
      with:
        requestId: tools.requestId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.