# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio SendGrid Single Sign-On SSO Certificates API
  version: 1.0.0
extends: openapi/sendgrid-sso-certificates-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v3/sso/certificates'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an SSO certificate to an integration
      effect: write
      questions:
      - Can I upload my identity provider's public certificate for single sign-on?
      - Which SSO integration does a new certificate need to be attached to?
      instructions:
      - text: Add SSO certificate {public_certificate} to integration {integration_id}.
        slots:
          public_certificate: requestBody.public_certificate
          integration_id: requestBody.integration_id
      - text: Upload IdP certificate {public_certificate} for SSO integration {integration_id}, enabled {enabled}.
        slots:
          public_certificate: requestBody.public_certificate
          integration_id: requestBody.integration_id
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/sso/certificates/{cert_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an SSO certificate
      effect: read
      questions:
      - Where can I check the details of a single SSO certificate?
      - Is a particular SSO certificate enabled?
      instructions:
      - text: Show SSO certificate {cert_id}.
        slots:
          cert_id: path.cert_id
      - text: Get the details of certificate {cert_id}.
        slots:
          cert_id: path.cert_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/sso/certificates/{cert_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an SSO certificate
      effect: destructive
      questions:
      - Can I remove an expired certificate from my SSO setup?
      - Where do I get a certificate's ID before deleting it?
      instructions:
      - text: Delete SSO certificate {cert_id}.
        slots:
          cert_id: path.cert_id
      - text: Remove certificate {cert_id} from single sign-on.
        slots:
          cert_id: path.cert_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/sso/certificates/{cert_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an SSO certificate
      effect: write
      questions:
      - Can I rotate the public key on an existing SSO certificate?
      - Is it possible to disable an SSO certificate without deleting it?
      instructions:
      - text: Replace the public key on SSO certificate {cert_id} with {public_certificate}.
        slots:
          cert_id: path.cert_id
          public_certificate: requestBody.public_certificate
      - text: Set SSO certificate {cert_id} enabled to {enabled}.
        slots:
          cert_id: path.cert_id
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/sso/integrations/{integration_id}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificates for an SSO integration
      effect: read
      questions:
      - Which certificates are attached to one of my SSO integrations?
      - Can I see all IdP certificates for a given integration?
      instructions:
      - text: List SSO certificates for integration {integration_id}.
        slots:
          integration_id: path.integration_id
      - text: Show every certificate on SSO integration {integration_id}.
        slots:
          integration_id: path.integration_id
      method: generated
      generated: '2026-09-24'