naftiko: 1.0.0-alpha2
info:
  label: helicone-api — Prompt2025
  description: 'helicone-api — Prompt2025. 20 operations. Lead operation: Prompt2025. Self-contained Naftiko capability covering
    one Helicone business surface.'
  tags:
  - Helicone
  - Prompt2025
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    HELICONE_API_KEY: HELICONE_API_KEY
capability:
  consumes:
  - type: http
    namespace: helicone-prompt2025
    baseUri: https://api.helicone.ai
    description: helicone-api — Prompt2025 business capability. Self-contained, no shared references.
    resources:
    - name: v1-prompt-2025
      path: /v1/prompt-2025
      operations:
      - name: createprompt2025
        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-prompt-2025-count
      path: /v1/prompt-2025/count
      operations:
      - name: getprompt2025count
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-prompt-2025-environments
      path: /v1/prompt-2025/environments
      operations:
      - name: getprompt2025environments
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-prompt-2025-id-promptId
      path: /v1/prompt-2025/id/{promptId}
      operations:
      - name: getprompt2025
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
    - name: v1-prompt-2025-id-promptId-rename
      path: /v1/prompt-2025/id/{promptId}/rename
      operations:
      - name: renameprompt2025
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-prompt-2025-id-promptId-tags
      path: /v1/prompt-2025/id/{promptId}/tags
      operations:
      - name: updateprompt2025tags
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-prompt-2025-id-promptId-versionId-inputs
      path: /v1/prompt-2025/id/{promptId}/{versionId}/inputs
      operations:
      - name: getprompt2025inputs
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
        - name: versionId
          in: path
          type: string
          required: true
        - name: requestId
          in: query
          type: string
          required: true
    - name: v1-prompt-2025-query
      path: /v1/prompt-2025/query
      operations:
      - name: getprompts2025
        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-prompt-2025-query-environment-version
      path: /v1/prompt-2025/query/environment-version
      operations:
      - name: getprompt2025environmentversion
        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-prompt-2025-query-production-version
      path: /v1/prompt-2025/query/production-version
      operations:
      - name: getprompt2025productionversion
        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-prompt-2025-query-total-versions
      path: /v1/prompt-2025/query/total-versions
      operations:
      - name: getprompt2025totalversions
        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-prompt-2025-query-version
      path: /v1/prompt-2025/query/version
      operations:
      - name: getprompt2025version
        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-prompt-2025-query-versions
      path: /v1/prompt-2025/query/versions
      operations:
      - name: getprompt2025versions
        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-prompt-2025-remove-environment
      path: /v1/prompt-2025/remove/environment
      operations:
      - name: removeenvironmentfromversion
        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-prompt-2025-tags
      path: /v1/prompt-2025/tags
      operations:
      - name: getprompt2025tags
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-prompt-2025-update
      path: /v1/prompt-2025/update
      operations:
      - name: updateprompt2025
        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-prompt-2025-update-environment
      path: /v1/prompt-2025/update/environment
      operations:
      - name: setpromptversionenvironment
        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-prompt-2025-promptId
      path: /v1/prompt-2025/{promptId}
      operations:
      - name: deleteprompt2025
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
    - name: v1-prompt-2025-promptId-versionId
      path: /v1/prompt-2025/{promptId}/{versionId}
      operations:
      - name: deleteprompt2025version
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
        - name: versionId
          in: path
          type: string
          required: true
    - name: v1-prompt-2025-promptVersionId-prompt-body
      path: /v1/prompt-2025/{promptVersionId}/prompt-body
      operations:
      - name: getprompt2025versionbody
        method: GET
        description: Get the full prompt body (messages, tools, etc.) for a specific prompt version.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: promptVersionId
          in: path
          type: string
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.HELICONE_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: helicone-prompt2025-rest
    port: 8080
    description: REST adapter for helicone-api — Prompt2025. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/v1/prompt-2025
      name: v1-prompt-2025
      description: REST surface for v1-prompt-2025.
      operations:
      - method: POST
        name: createprompt2025
        description: createprompt2025
        call: helicone-prompt2025.createprompt2025
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/count
      name: v1-prompt-2025-count
      description: REST surface for v1-prompt-2025-count.
      operations:
      - method: GET
        name: getprompt2025count
        description: getprompt2025count
        call: helicone-prompt2025.getprompt2025count
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/environments
      name: v1-prompt-2025-environments
      description: REST surface for v1-prompt-2025-environments.
      operations:
      - method: GET
        name: getprompt2025environments
        description: getprompt2025environments
        call: helicone-prompt2025.getprompt2025environments
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/id/{promptid}
      name: v1-prompt-2025-id-promptid
      description: REST surface for v1-prompt-2025-id-promptId.
      operations:
      - method: GET
        name: getprompt2025
        description: getprompt2025
        call: helicone-prompt2025.getprompt2025
        with:
          promptId: rest.promptId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/id/{promptid}/rename
      name: v1-prompt-2025-id-promptid-rename
      description: REST surface for v1-prompt-2025-id-promptId-rename.
      operations:
      - method: POST
        name: renameprompt2025
        description: renameprompt2025
        call: helicone-prompt2025.renameprompt2025
        with:
          promptId: rest.promptId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/id/{promptid}/tags
      name: v1-prompt-2025-id-promptid-tags
      description: REST surface for v1-prompt-2025-id-promptId-tags.
      operations:
      - method: PATCH
        name: updateprompt2025tags
        description: updateprompt2025tags
        call: helicone-prompt2025.updateprompt2025tags
        with:
          promptId: rest.promptId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/id/{promptid}/{versionid}/inputs
      name: v1-prompt-2025-id-promptid-versionid-inputs
      description: REST surface for v1-prompt-2025-id-promptId-versionId-inputs.
      operations:
      - method: GET
        name: getprompt2025inputs
        description: getprompt2025inputs
        call: helicone-prompt2025.getprompt2025inputs
        with:
          promptId: rest.promptId
          versionId: rest.versionId
          requestId: rest.requestId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/query
      name: v1-prompt-2025-query
      description: REST surface for v1-prompt-2025-query.
      operations:
      - method: POST
        name: getprompts2025
        description: getprompts2025
        call: helicone-prompt2025.getprompts2025
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/query/environment-version
      name: v1-prompt-2025-query-environment-version
      description: REST surface for v1-prompt-2025-query-environment-version.
      operations:
      - method: POST
        name: getprompt2025environmentversion
        description: getprompt2025environmentversion
        call: helicone-prompt2025.getprompt2025environmentversion
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/query/production-version
      name: v1-prompt-2025-query-production-version
      description: REST surface for v1-prompt-2025-query-production-version.
      operations:
      - method: POST
        name: getprompt2025productionversion
        description: getprompt2025productionversion
        call: helicone-prompt2025.getprompt2025productionversion
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/query/total-versions
      name: v1-prompt-2025-query-total-versions
      description: REST surface for v1-prompt-2025-query-total-versions.
      operations:
      - method: POST
        name: getprompt2025totalversions
        description: getprompt2025totalversions
        call: helicone-prompt2025.getprompt2025totalversions
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/query/version
      name: v1-prompt-2025-query-version
      description: REST surface for v1-prompt-2025-query-version.
      operations:
      - method: POST
        name: getprompt2025version
        description: getprompt2025version
        call: helicone-prompt2025.getprompt2025version
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/query/versions
      name: v1-prompt-2025-query-versions
      description: REST surface for v1-prompt-2025-query-versions.
      operations:
      - method: POST
        name: getprompt2025versions
        description: getprompt2025versions
        call: helicone-prompt2025.getprompt2025versions
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/remove/environment
      name: v1-prompt-2025-remove-environment
      description: REST surface for v1-prompt-2025-remove-environment.
      operations:
      - method: POST
        name: removeenvironmentfromversion
        description: removeenvironmentfromversion
        call: helicone-prompt2025.removeenvironmentfromversion
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/tags
      name: v1-prompt-2025-tags
      description: REST surface for v1-prompt-2025-tags.
      operations:
      - method: GET
        name: getprompt2025tags
        description: getprompt2025tags
        call: helicone-prompt2025.getprompt2025tags
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/update
      name: v1-prompt-2025-update
      description: REST surface for v1-prompt-2025-update.
      operations:
      - method: POST
        name: updateprompt2025
        description: updateprompt2025
        call: helicone-prompt2025.updateprompt2025
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/update/environment
      name: v1-prompt-2025-update-environment
      description: REST surface for v1-prompt-2025-update-environment.
      operations:
      - method: POST
        name: setpromptversionenvironment
        description: setpromptversionenvironment
        call: helicone-prompt2025.setpromptversionenvironment
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/{promptid}
      name: v1-prompt-2025-promptid
      description: REST surface for v1-prompt-2025-promptId.
      operations:
      - method: DELETE
        name: deleteprompt2025
        description: deleteprompt2025
        call: helicone-prompt2025.deleteprompt2025
        with:
          promptId: rest.promptId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/{promptid}/{versionid}
      name: v1-prompt-2025-promptid-versionid
      description: REST surface for v1-prompt-2025-promptId-versionId.
      operations:
      - method: DELETE
        name: deleteprompt2025version
        description: deleteprompt2025version
        call: helicone-prompt2025.deleteprompt2025version
        with:
          promptId: rest.promptId
          versionId: rest.versionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/prompt-2025/{promptversionid}/prompt-body
      name: v1-prompt-2025-promptversionid-prompt-body
      description: REST surface for v1-prompt-2025-promptVersionId-prompt-body.
      operations:
      - method: GET
        name: getprompt2025versionbody
        description: Get the full prompt body (messages, tools, etc.) for a specific prompt version.
        call: helicone-prompt2025.getprompt2025versionbody
        with:
          promptVersionId: rest.promptVersionId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: helicone-prompt2025-mcp
    port: 9090
    transport: http
    description: MCP adapter for helicone-api — Prompt2025. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: createprompt2025
      description: createprompt2025
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.createprompt2025
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025count
      description: getprompt2025count
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-prompt2025.getprompt2025count
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025environments
      description: getprompt2025environments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-prompt2025.getprompt2025environments
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025
      description: getprompt2025
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-prompt2025.getprompt2025
      with:
        promptId: tools.promptId
      outputParameters:
      - type: object
        mapping: $.
    - name: renameprompt2025
      description: renameprompt2025
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.renameprompt2025
      with:
        promptId: tools.promptId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: updateprompt2025tags
      description: updateprompt2025tags
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: helicone-prompt2025.updateprompt2025tags
      with:
        promptId: tools.promptId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025inputs
      description: getprompt2025inputs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-prompt2025.getprompt2025inputs
      with:
        promptId: tools.promptId
        versionId: tools.versionId
        requestId: tools.requestId
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompts2025
      description: getprompts2025
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.getprompts2025
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025environmentversion
      description: getprompt2025environmentversion
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.getprompt2025environmentversion
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025productionversion
      description: getprompt2025productionversion
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.getprompt2025productionversion
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025totalversions
      description: getprompt2025totalversions
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.getprompt2025totalversions
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025version
      description: getprompt2025version
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.getprompt2025version
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025versions
      description: getprompt2025versions
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.getprompt2025versions
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: removeenvironmentfromversion
      description: removeenvironmentfromversion
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.removeenvironmentfromversion
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getprompt2025tags
      description: getprompt2025tags
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-prompt2025.getprompt2025tags
      outputParameters:
      - type: object
        mapping: $.
    - name: updateprompt2025
      description: updateprompt2025
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.updateprompt2025
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: setpromptversionenvironment
      description: setpromptversionenvironment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-prompt2025.setpromptversionenvironment
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteprompt2025
      description: deleteprompt2025
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: helicone-prompt2025.deleteprompt2025
      with:
        promptId: tools.promptId
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteprompt2025version
      description: deleteprompt2025version
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: helicone-prompt2025.deleteprompt2025version
      with:
        promptId: tools.promptId
        versionId: tools.versionId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-full-prompt-body-messages
      description: Get the full prompt body (messages, tools, etc.) for a specific prompt version.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: helicone-prompt2025.getprompt2025versionbody
      with:
        promptVersionId: tools.promptVersionId
      outputParameters:
      - type: object
        mapping: $.