Konnect API - Go SDK — Portal Emails

naftiko: 1.0.0-alpha2
info:
  label: Konnect API - Go SDK — Portal Emails
  description: 'Konnect API - Go SDK — Portal Emails. 19 operations. Lead operation: List email domains. Self-contained Naftiko
    capability covering one Kong business surface.'
  tags:
  - Kong
  - Portal Emails
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    KONG_API_KEY: KONG_API_KEY
capability:
  consumes:
  - type: http
    namespace: konnect-platform-portal-emails
    baseUri: https://global.api.konghq.com
    description: Konnect API - Go SDK — Portal Emails business capability. Self-contained, no shared references.
    resources:
    - name: v3-portals-email-domains
      path: /v3/portals/email-domains
      operations:
      - name: listemaildomains
        method: GET
        description: List email domains
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: Filter email domains returned in the response.
      - name: createemaildomain
        method: POST
        description: Create an email domain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v3-portals-email-domains-emailDomain
      path: /v3/portals/email-domains/{emailDomain}
      operations:
      - name: getemaildomain
        method: GET
        description: Get an email domain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteemaildomain
        method: DELETE
        description: Delete an email domain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-email-templates
      path: /v3/portals/email-templates
      operations:
      - name: listdefaultemailtemplates
        method: GET
        description: List default email templates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-email-templates-variables
      path: /v3/portals/email-templates/variables
      operations:
      - name: listemailtemplatevariables
        method: GET
        description: List email template variables
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-email-templates-templateName
      path: /v3/portals/email-templates/{templateName}
      operations:
      - name: getdefaultemailtemplate
        method: GET
        description: Get default email template
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-portalId-email-config
      path: /v3/portals/{portalId}/email-config
      operations:
      - name: getemailconfig
        method: GET
        description: Get the email config for the portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createportalemailconfig
        method: POST
        description: Create the email config for a portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: updateportalemailconfig
        method: PATCH
        description: Setup the email config for a portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteportalemailconfig
        method: DELETE
        description: Delete portal email config
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-portalId-email-delivery
      path: /v3/portals/{portalId}/email-delivery
      operations:
      - name: getemaildelivery
        method: GET
        description: Get the email delivery for the portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateemaildelivery
        method: PATCH
        description: Setup the email delivery for a portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteemaildelivery
        method: DELETE
        description: Delete email delivery
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-portalId-email-templates
      path: /v3/portals/{portalId}/email-templates
      operations:
      - name: listportalcustomemailtemplates
        method: GET
        description: List custom email templates for a portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-portalId-email-templates-templateName
      path: /v3/portals/{portalId}/email-templates/{templateName}
      operations:
      - name: getportalcustomemailtemplate
        method: GET
        description: Get custom email template used in a portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateportalcustomemailtemplate
        method: PATCH
        description: Update custom email template for a portal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteportalcustomemailtemplate
        method: DELETE
        description: Delete custom email template
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-portals-portalId-email-templates-templateName-send-test-email
      path: /v3/portals/{portalId}/email-templates/{templateName}/send-test-email
      operations:
      - name: postportalcustomemailtestsend
        method: POST
        description: Send Test Email
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.KONG_API_KEY}}'
  exposes:
  - type: rest
    namespace: konnect-platform-portal-emails-rest
    port: 8080
    description: REST adapter for Konnect API - Go SDK — Portal Emails. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v3/portals/email-domains
      name: v3-portals-email-domains
      description: REST surface for v3-portals-email-domains.
      operations:
      - method: GET
        name: listemaildomains
        description: List email domains
        call: konnect-platform-portal-emails.listemaildomains
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createemaildomain
        description: Create an email domain
        call: konnect-platform-portal-emails.createemaildomain
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/email-domains/{emaildomain}
      name: v3-portals-email-domains-emaildomain
      description: REST surface for v3-portals-email-domains-emailDomain.
      operations:
      - method: GET
        name: getemaildomain
        description: Get an email domain
        call: konnect-platform-portal-emails.getemaildomain
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteemaildomain
        description: Delete an email domain
        call: konnect-platform-portal-emails.deleteemaildomain
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/email-templates
      name: v3-portals-email-templates
      description: REST surface for v3-portals-email-templates.
      operations:
      - method: GET
        name: listdefaultemailtemplates
        description: List default email templates
        call: konnect-platform-portal-emails.listdefaultemailtemplates
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/email-templates/variables
      name: v3-portals-email-templates-variables
      description: REST surface for v3-portals-email-templates-variables.
      operations:
      - method: GET
        name: listemailtemplatevariables
        description: List email template variables
        call: konnect-platform-portal-emails.listemailtemplatevariables
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/email-templates/{templatename}
      name: v3-portals-email-templates-templatename
      description: REST surface for v3-portals-email-templates-templateName.
      operations:
      - method: GET
        name: getdefaultemailtemplate
        description: Get default email template
        call: konnect-platform-portal-emails.getdefaultemailtemplate
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/{portalid}/email-config
      name: v3-portals-portalid-email-config
      description: REST surface for v3-portals-portalId-email-config.
      operations:
      - method: GET
        name: getemailconfig
        description: Get the email config for the portal
        call: konnect-platform-portal-emails.getemailconfig
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createportalemailconfig
        description: Create the email config for a portal
        call: konnect-platform-portal-emails.createportalemailconfig
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateportalemailconfig
        description: Setup the email config for a portal
        call: konnect-platform-portal-emails.updateportalemailconfig
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteportalemailconfig
        description: Delete portal email config
        call: konnect-platform-portal-emails.deleteportalemailconfig
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/{portalid}/email-delivery
      name: v3-portals-portalid-email-delivery
      description: REST surface for v3-portals-portalId-email-delivery.
      operations:
      - method: GET
        name: getemaildelivery
        description: Get the email delivery for the portal
        call: konnect-platform-portal-emails.getemaildelivery
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateemaildelivery
        description: Setup the email delivery for a portal
        call: konnect-platform-portal-emails.updateemaildelivery
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteemaildelivery
        description: Delete email delivery
        call: konnect-platform-portal-emails.deleteemaildelivery
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/{portalid}/email-templates
      name: v3-portals-portalid-email-templates
      description: REST surface for v3-portals-portalId-email-templates.
      operations:
      - method: GET
        name: listportalcustomemailtemplates
        description: List custom email templates for a portal
        call: konnect-platform-portal-emails.listportalcustomemailtemplates
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/{portalid}/email-templates/{templatename}
      name: v3-portals-portalid-email-templates-templatename
      description: REST surface for v3-portals-portalId-email-templates-templateName.
      operations:
      - method: GET
        name: getportalcustomemailtemplate
        description: Get custom email template used in a portal
        call: konnect-platform-portal-emails.getportalcustomemailtemplate
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateportalcustomemailtemplate
        description: Update custom email template for a portal
        call: konnect-platform-portal-emails.updateportalcustomemailtemplate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteportalcustomemailtemplate
        description: Delete custom email template
        call: konnect-platform-portal-emails.deleteportalcustomemailtemplate
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/portals/{portalid}/email-templates/{templatename}/send-test-email
      name: v3-portals-portalid-email-templates-templatename-send-test-email
      description: REST surface for v3-portals-portalId-email-templates-templateName-send-test-email.
      operations:
      - method: POST
        name: postportalcustomemailtestsend
        description: Send Test Email
        call: konnect-platform-portal-emails.postportalcustomemailtestsend
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: konnect-platform-portal-emails-mcp
    port: 9090
    transport: http
    description: MCP adapter for Konnect API - Go SDK — Portal Emails. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-email-domains
      description: List email domains
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.listemaildomains
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: create-email-domain
      description: Create an email domain
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: konnect-platform-portal-emails.createemaildomain
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-email-domain
      description: Get an email domain
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.getemaildomain
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-email-domain
      description: Delete an email domain
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: konnect-platform-portal-emails.deleteemaildomain
      outputParameters:
      - type: object
        mapping: $.
    - name: list-default-email-templates
      description: List default email templates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.listdefaultemailtemplates
      outputParameters:
      - type: object
        mapping: $.
    - name: list-email-template-variables
      description: List email template variables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.listemailtemplatevariables
      outputParameters:
      - type: object
        mapping: $.
    - name: get-default-email-template
      description: Get default email template
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.getdefaultemailtemplate
      outputParameters:
      - type: object
        mapping: $.
    - name: get-email-config-portal
      description: Get the email config for the portal
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.getemailconfig
      outputParameters:
      - type: object
        mapping: $.
    - name: create-email-config-portal
      description: Create the email config for a portal
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: konnect-platform-portal-emails.createportalemailconfig
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: setup-email-config-portal
      description: Setup the email config for a portal
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.updateportalemailconfig
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-portal-email-config
      description: Delete portal email config
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: konnect-platform-portal-emails.deleteportalemailconfig
      outputParameters:
      - type: object
        mapping: $.
    - name: get-email-delivery-portal
      description: Get the email delivery for the portal
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.getemaildelivery
      outputParameters:
      - type: object
        mapping: $.
    - name: setup-email-delivery-portal
      description: Setup the email delivery for a portal
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.updateemaildelivery
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-email-delivery
      description: Delete email delivery
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: konnect-platform-portal-emails.deleteemaildelivery
      outputParameters:
      - type: object
        mapping: $.
    - name: list-custom-email-templates-portal
      description: List custom email templates for a portal
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.listportalcustomemailtemplates
      outputParameters:
      - type: object
        mapping: $.
    - name: get-custom-email-template-used
      description: Get custom email template used in a portal
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.getportalcustomemailtemplate
      outputParameters:
      - type: object
        mapping: $.
    - name: update-custom-email-template-portal
      description: Update custom email template for a portal
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-portal-emails.updateportalcustomemailtemplate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-custom-email-template
      description: Delete custom email template
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: konnect-platform-portal-emails.deleteportalcustomemailtemplate
      outputParameters:
      - type: object
        mapping: $.
    - name: send-test-email
      description: Send Test Email
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: konnect-platform-portal-emails.postportalcustomemailtestsend
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.