godaddy-certificates — v2

naftiko: 1.0.0-alpha2
info:
  label: godaddy-certificates — v2
  description: 'godaddy-certificates — v2. 11 operations. Lead operation: Search for certificate details by entitlement. Self-contained
    Naftiko capability covering one Godaddy business surface.'
  tags:
  - Godaddy
  - v2
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GODADDY_API_KEY: GODADDY_API_KEY
capability:
  consumes:
  - type: http
    namespace: certificates-v2
    baseUri: https://api.ote-godaddy.com
    description: godaddy-certificates — v2 business capability. Self-contained, no shared references.
    resources:
    - name: v2-certificates
      path: /v2/certificates
      operations:
      - name: certificategetentitlement
        method: GET
        description: Search for certificate details by entitlement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entitlementId
          in: query
          type: string
          description: Entitlement id to lookup
          required: true
        - name: latest
          in: query
          type: boolean
          description: Fetch only the most recent certificate
      - name: certificatecreate
        method: POST
        description: Create a pending order for certificate
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-Market-Id
          in: header
          type: string
          description: Setting locale for communications such as emails and error messages
        - name: subscriptionCertificateCreate
          in: body
          type: string
          description: The certificate order information
          required: true
    - name: v2-certificates-download
      path: /v2/certificates/download
      operations:
      - name: certificatedownloadentitlement
        method: GET
        description: Download certificate by entitlement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entitlementId
          in: query
          type: string
          description: Entitlement id to download
          required: true
    - name: v2-certificates-subscription-guid
      path: /v2/certificates/subscription/{guid}
      operations:
      - name: retrievesslbydomainsubscriptionreseller
        method: GET
        description: GET a page of certificates for a specific domain product
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-certificates-subscriptions-search
      path: /v2/certificates/subscriptions/search
      operations:
      - name: retrievesslbydomainreseller
        method: GET
        description: Get a page of subscriptions by domain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-certificates-certificateId-reissue
      path: /v2/certificates/{certificateId}/reissue
      operations:
      - name: certificatereissue
        method: POST
        description: Reissue active certificate
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: certificateId
          in: path
          type: string
          description: Certificate id to reissue
          required: true
        - name: reissueCreate
          in: body
          type: string
          description: The reissue request info
    - name: v2-customers-customerId-certificates
      path: /v2/customers/{customerId}/certificates
      operations:
      - name: getcustomercertificatesbycustomerid
        method: GET
        description: Retrieve customer's certificates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-customers-customerId-certificates-acme-externalAccountBinding
      path: /v2/customers/{customerId}/certificates/acme/externalAccountBinding
      operations:
      - name: getacmeexternalaccountbinding
        method: GET
        description: Retrieves the external account binding for the specified customer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-customers-customerId-certificates-certificateId
      path: /v2/customers/{customerId}/certificates/{certificateId}
      operations:
      - name: getcertificatedetailbycertidentifier
        method: GET
        description: Retrieve individual certificate details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-customers-customerId-certificates-certificateId-domainVerifications
      path: /v2/customers/{customerId}/certificates/{certificateId}/domainVerifications
      operations:
      - name: getdomaininformationbycertificateid
        method: GET
        description: Retrieve domain verification status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-customers-customerId-certificates-certificateId-domainVerifications-domain
      path: /v2/customers/{customerId}/certificates/{certificateId}/domainVerifications/{domain}
      operations:
      - name: getdomaindetailsbydomain
        method: GET
        description: Retrieve detailed information for supplied domain
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: certificates-v2-rest
    port: 8080
    description: REST adapter for godaddy-certificates — v2. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/v2/certificates
      name: v2-certificates
      description: REST surface for v2-certificates.
      operations:
      - method: GET
        name: certificategetentitlement
        description: Search for certificate details by entitlement
        call: certificates-v2.certificategetentitlement
        with:
          entitlementId: rest.entitlementId
          latest: rest.latest
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: certificatecreate
        description: Create a pending order for certificate
        call: certificates-v2.certificatecreate
        with:
          X-Market-Id: rest.X-Market-Id
          subscriptionCertificateCreate: rest.subscriptionCertificateCreate
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/certificates/download
      name: v2-certificates-download
      description: REST surface for v2-certificates-download.
      operations:
      - method: GET
        name: certificatedownloadentitlement
        description: Download certificate by entitlement
        call: certificates-v2.certificatedownloadentitlement
        with:
          entitlementId: rest.entitlementId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/certificates/subscription/{guid}
      name: v2-certificates-subscription-guid
      description: REST surface for v2-certificates-subscription-guid.
      operations:
      - method: GET
        name: retrievesslbydomainsubscriptionreseller
        description: GET a page of certificates for a specific domain product
        call: certificates-v2.retrievesslbydomainsubscriptionreseller
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/certificates/subscriptions/search
      name: v2-certificates-subscriptions-search
      description: REST surface for v2-certificates-subscriptions-search.
      operations:
      - method: GET
        name: retrievesslbydomainreseller
        description: Get a page of subscriptions by domain
        call: certificates-v2.retrievesslbydomainreseller
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/certificates/{certificateid}/reissue
      name: v2-certificates-certificateid-reissue
      description: REST surface for v2-certificates-certificateId-reissue.
      operations:
      - method: POST
        name: certificatereissue
        description: Reissue active certificate
        call: certificates-v2.certificatereissue
        with:
          certificateId: rest.certificateId
          reissueCreate: rest.reissueCreate
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/customers/{customerid}/certificates
      name: v2-customers-customerid-certificates
      description: REST surface for v2-customers-customerId-certificates.
      operations:
      - method: GET
        name: getcustomercertificatesbycustomerid
        description: Retrieve customer's certificates
        call: certificates-v2.getcustomercertificatesbycustomerid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/customers/{customerid}/certificates/acme/externalaccountbinding
      name: v2-customers-customerid-certificates-acme-externalaccountbinding
      description: REST surface for v2-customers-customerId-certificates-acme-externalAccountBinding.
      operations:
      - method: GET
        name: getacmeexternalaccountbinding
        description: Retrieves the external account binding for the specified customer
        call: certificates-v2.getacmeexternalaccountbinding
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/customers/{customerid}/certificates/{certificateid}
      name: v2-customers-customerid-certificates-certificateid
      description: REST surface for v2-customers-customerId-certificates-certificateId.
      operations:
      - method: GET
        name: getcertificatedetailbycertidentifier
        description: Retrieve individual certificate details
        call: certificates-v2.getcertificatedetailbycertidentifier
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/customers/{customerid}/certificates/{certificateid}/domainverifications
      name: v2-customers-customerid-certificates-certificateid-domainverifications
      description: REST surface for v2-customers-customerId-certificates-certificateId-domainVerifications.
      operations:
      - method: GET
        name: getdomaininformationbycertificateid
        description: Retrieve domain verification status
        call: certificates-v2.getdomaininformationbycertificateid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/customers/{customerid}/certificates/{certificateid}/domainverifications/{domain}
      name: v2-customers-customerid-certificates-certificateid-domainverifications-domain
      description: REST surface for v2-customers-customerId-certificates-certificateId-domainVerifications-domain.
      operations:
      - method: GET
        name: getdomaindetailsbydomain
        description: Retrieve detailed information for supplied domain
        call: certificates-v2.getdomaindetailsbydomain
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: certificates-v2-mcp
    port: 9090
    transport: http
    description: MCP adapter for godaddy-certificates — v2. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: search-certificate-details-entitlement
      description: Search for certificate details by entitlement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.certificategetentitlement
      with:
        entitlementId: tools.entitlementId
        latest: tools.latest
      outputParameters:
      - type: object
        mapping: $.
    - name: create-pending-order-certificate
      description: Create a pending order for certificate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: certificates-v2.certificatecreate
      with:
        X-Market-Id: tools.X-Market-Id
        subscriptionCertificateCreate: tools.subscriptionCertificateCreate
      outputParameters:
      - type: object
        mapping: $.
    - name: download-certificate-entitlement
      description: Download certificate by entitlement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.certificatedownloadentitlement
      with:
        entitlementId: tools.entitlementId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-page-certificates-specific-domain
      description: GET a page of certificates for a specific domain product
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.retrievesslbydomainsubscriptionreseller
      outputParameters:
      - type: object
        mapping: $.
    - name: get-page-subscriptions-domain
      description: Get a page of subscriptions by domain
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.retrievesslbydomainreseller
      outputParameters:
      - type: object
        mapping: $.
    - name: reissue-active-certificate
      description: Reissue active certificate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: certificates-v2.certificatereissue
      with:
        certificateId: tools.certificateId
        reissueCreate: tools.reissueCreate
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-customer-s-certificates
      description: Retrieve customer's certificates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.getcustomercertificatesbycustomerid
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieves-external-account-binding-specified
      description: Retrieves the external account binding for the specified customer
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.getacmeexternalaccountbinding
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-individual-certificate-details
      description: Retrieve individual certificate details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.getcertificatedetailbycertidentifier
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-domain-verification-status
      description: Retrieve domain verification status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.getdomaininformationbycertificateid
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-detailed-information-supplied-domain
      description: Retrieve detailed information for supplied domain
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: certificates-v2.getdomaindetailsbydomain
      outputParameters:
      - type: object
        mapping: $.