# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure CodeSigningManagementClient Certificate…
  version: 1.0.0
extends: openapi/microsoft-azure-certificate-profiles-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CodeSigning/codeSigningAccounts/{accountName}/certificateProfiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate profiles in a signing account
      effect: read
      questions:
      - Which certificate profiles are set up in my Trusted Signing account?
      - Can I see every code signing certificate profile under one account?
      instructions:
      - text: List certificate profiles in trusted signing account {accountName}.
        slots:
          accountName: path.accountName
      - text: Show the code signing profiles under account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CodeSigning/codeSigningAccounts/{accountName}/certificateProfiles/{profileName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a code signing certificate profile
      effect: read
      questions:
      - What are the details of a specific certificate profile?
      - Can I check the status of one code signing profile by name?
      instructions:
      - text: Get certificate profile {profileName} in signing account {accountName}.
        slots:
          profileName: path.profileName
          accountName: path.accountName
      - text: Show the details of code signing profile {profileName}.
        slots:
          profileName: path.profileName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CodeSigning/codeSigningAccounts/{accountName}/certificateProfiles/{profileName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a code signing certificate profile
      effect: write
      questions:
      - How do I create a certificate profile for code signing?
      - Can I add a new certificate profile to an existing Trusted Signing account?
      instructions:
      - text: Create certificate profile {profileName} in signing account {accountName}.
        slots:
          profileName: path.profileName
          accountName: path.accountName
      - text: Add a new code signing profile called {profileName} under {accountName}.
        slots:
          profileName: path.profileName
          accountName: path.accountName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CodeSigning/codeSigningAccounts/{accountName}/certificateProfiles/{profileName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a code signing certificate profile
      effect: destructive
      questions:
      - Can I delete a certificate profile I no longer sign with?
      - Is removing a code signing profile permanent?
      instructions:
      - text: Delete certificate profile {profileName} from signing account {accountName}.
        slots:
          profileName: path.profileName
          accountName: path.accountName
      - text: Remove code signing profile {profileName} under {accountName}.
        slots:
          profileName: path.profileName
          accountName: path.accountName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CodeSigning/codeSigningAccounts/{accountName}/certificateProfiles/{profileName}/revokeCertificate'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a code signing certificate
      effect: destructive
      questions:
      - How do I revoke a compromised code signing certificate?
      - Can I backdate a certificate revocation with an effective time and reason?
      instructions:
      - text: Revoke cert {serialNumber} (thumbprint {thumbprint}) in profile {profileName} of {accountName}, effective {effectiveAt}, reason {reason}.
        slots:
          serialNumber: requestBody.serialNumber
          thumbprint: requestBody.thumbprint
          profileName: path.profileName
          accountName: path.accountName
          effectiveAt: requestBody.effectiveAt
          reason: requestBody.reason
      - text: Revoke certificate {serialNumber} under profile {profileName} because {reason}.
        slots:
          serialNumber: requestBody.serialNumber
          profileName: path.profileName
          reason: requestBody.reason
      method: generated
      generated: '2026-10-01'