naftiko: 1.0.0-alpha2
info:
  label: KYC V2 API — Individual Entity Elements
  description: 'KYC V2 API — Individual Entity Elements. 8 operations. Lead operation: Delete an address. Self-contained Naftiko
    capability covering one Frankieone business surface.'
  tags:
  - Frankieone
  - Individual Entity Elements
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    FRANKIEONE_API_KEY: FRANKIEONE_API_KEY
capability:
  consumes:
  - type: http
    namespace: kyc-v2-individual-entity-elements
    baseUri: https://api.uat.frankie.one
    description: KYC V2 API — Individual Entity Elements business capability. Self-contained, no shared references.
    resources:
    - name: v2-individuals-entityId-addresses-addressId
      path: /v2/individuals/{entityId}/addresses/{addressId}
      operations:
      - name: deleteaddress
        method: DELETE
        description: Delete an address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-individuals-entityId-consents-consentType
      path: /v2/individuals/{entityId}/consents/{consentType}
      operations:
      - name: deleteconsent
        method: DELETE
        description: Withdraw a previously provided consent
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-individuals-entityId-datesOfBirth-dateOfBirthId
      path: /v2/individuals/{entityId}/datesOfBirth/{dateOfBirthId}
      operations:
      - name: deletedob
        method: DELETE
        description: Delete a date of birth
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-individuals-entityId-emailaddresses-emailAddressId
      path: /v2/individuals/{entityId}/emailaddresses/{emailAddressId}
      operations:
      - name: deleteemailaddress
        method: DELETE
        description: Delete an email address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-individuals-entityId-externalreferences
      path: /v2/individuals/{entityId}/externalreferences
      operations:
      - name: getexternalreference
        method: GET
        description: Get a list of external references
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-individuals-entityId-externalreferences-referenceId
      path: /v2/individuals/{entityId}/externalreferences/{referenceId}
      operations:
      - name: deleteexternalreference
        method: DELETE
        description: Delete an external reference
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-individuals-entityId-names-nameId
      path: /v2/individuals/{entityId}/names/{nameId}
      operations:
      - name: deletename
        method: DELETE
        description: Delete a name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-individuals-entityId-phonenumbers-phoneNumberId
      path: /v2/individuals/{entityId}/phonenumbers/{phoneNumberId}
      operations:
      - name: deletephonenumber
        method: DELETE
        description: Delete phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.FRANKIEONE_API_KEY}}'
  exposes:
  - type: rest
    namespace: kyc-v2-individual-entity-elements-rest
    port: 8080
    description: REST adapter for KYC V2 API — Individual Entity Elements. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v2/individuals/{entityid}/addresses/{addressid}
      name: v2-individuals-entityid-addresses-addressid
      description: REST surface for v2-individuals-entityId-addresses-addressId.
      operations:
      - method: DELETE
        name: deleteaddress
        description: Delete an address
        call: kyc-v2-individual-entity-elements.deleteaddress
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/individuals/{entityid}/consents/{consenttype}
      name: v2-individuals-entityid-consents-consenttype
      description: REST surface for v2-individuals-entityId-consents-consentType.
      operations:
      - method: DELETE
        name: deleteconsent
        description: Withdraw a previously provided consent
        call: kyc-v2-individual-entity-elements.deleteconsent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/individuals/{entityid}/datesofbirth/{dateofbirthid}
      name: v2-individuals-entityid-datesofbirth-dateofbirthid
      description: REST surface for v2-individuals-entityId-datesOfBirth-dateOfBirthId.
      operations:
      - method: DELETE
        name: deletedob
        description: Delete a date of birth
        call: kyc-v2-individual-entity-elements.deletedob
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/individuals/{entityid}/emailaddresses/{emailaddressid}
      name: v2-individuals-entityid-emailaddresses-emailaddressid
      description: REST surface for v2-individuals-entityId-emailaddresses-emailAddressId.
      operations:
      - method: DELETE
        name: deleteemailaddress
        description: Delete an email address
        call: kyc-v2-individual-entity-elements.deleteemailaddress
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/individuals/{entityid}/externalreferences
      name: v2-individuals-entityid-externalreferences
      description: REST surface for v2-individuals-entityId-externalreferences.
      operations:
      - method: GET
        name: getexternalreference
        description: Get a list of external references
        call: kyc-v2-individual-entity-elements.getexternalreference
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/individuals/{entityid}/externalreferences/{referenceid}
      name: v2-individuals-entityid-externalreferences-referenceid
      description: REST surface for v2-individuals-entityId-externalreferences-referenceId.
      operations:
      - method: DELETE
        name: deleteexternalreference
        description: Delete an external reference
        call: kyc-v2-individual-entity-elements.deleteexternalreference
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/individuals/{entityid}/names/{nameid}
      name: v2-individuals-entityid-names-nameid
      description: REST surface for v2-individuals-entityId-names-nameId.
      operations:
      - method: DELETE
        name: deletename
        description: Delete a name
        call: kyc-v2-individual-entity-elements.deletename
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/individuals/{entityid}/phonenumbers/{phonenumberid}
      name: v2-individuals-entityid-phonenumbers-phonenumberid
      description: REST surface for v2-individuals-entityId-phonenumbers-phoneNumberId.
      operations:
      - method: DELETE
        name: deletephonenumber
        description: Delete phone number
        call: kyc-v2-individual-entity-elements.deletephonenumber
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: kyc-v2-individual-entity-elements-mcp
    port: 9090
    transport: http
    description: MCP adapter for KYC V2 API — Individual Entity Elements. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: delete-address
      description: Delete an address
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: kyc-v2-individual-entity-elements.deleteaddress
      outputParameters:
      - type: object
        mapping: $.
    - name: withdraw-previously-provided-consent
      description: Withdraw a previously provided consent
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: kyc-v2-individual-entity-elements.deleteconsent
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-date-birth
      description: Delete a date of birth
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: kyc-v2-individual-entity-elements.deletedob
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-email-address
      description: Delete an email address
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: kyc-v2-individual-entity-elements.deleteemailaddress
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-external-references
      description: Get a list of external references
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: kyc-v2-individual-entity-elements.getexternalreference
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-external-reference
      description: Delete an external reference
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: kyc-v2-individual-entity-elements.deleteexternalreference
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-name
      description: Delete a name
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: kyc-v2-individual-entity-elements.deletename
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-phone-number
      description: Delete phone number
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: kyc-v2-individual-entity-elements.deletephonenumber
      outputParameters:
      - type: object
        mapping: $.