API Evangelist conversational phrasing for OpenAI Certificates API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OpenAI Certificates API
  version: 1.0.0
extends: openapi/openai-certificates-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/organization/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List the organization's certificates
      effect: read
      questions:
      - Which certificates have been uploaded to my organization?
      - Can I page through every certificate uploaded at the org level?
      instructions:
      - text: List all certificates uploaded to my organization.
      - text: Show the first {limit} organization certificates.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/certificates'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a certificate to the organization
      effect: write
      questions:
      - How do I upload a certificate to my OpenAI organization?
      - Does uploading a certificate turn it on automatically, and how many can I upload?
      instructions:
      - text: Upload certificate {certificate} to the organization as {name}.
        slots:
          certificate: requestBody.certificate
          name: requestBody.name
      - text: 'Add this PEM certificate to my org: {certificate}.'
        slots:
          certificate: requestBody.certificate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/certificates/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate certificates for the whole organization
      effect: write
      questions:
      - How do I turn on uploaded certificates across my entire organization?
      - How many certificates can I activate at the org level in one request?
      instructions:
      - text: Activate certificates {certificate_ids} at the organization level.
        slots:
          certificate_ids: requestBody.certificate_ids
      - text: Turn on certificates {certificate_ids} for the whole org.
        slots:
          certificate_ids: requestBody.certificate_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/certificates/deactivate'].post
  update:
    x-apievangelist-phrasing:
      intent: Deactivate certificates for the whole organization
      effect: write
      questions:
      - Can I switch off certificates across my whole organization?
      - Is org-level certificate deactivation safe to retry if the call times out?
      instructions:
      - text: Deactivate certificates {certificate_ids} at the organization level.
        slots:
          certificate_ids: requestBody.certificate_ids
      - text: Turn off certificates {certificate_ids} for the whole org.
        slots:
          certificate_ids: requestBody.certificate_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/certificates/{certificate_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve an uploaded certificate
      effect: read
      questions:
      - Can I look up a certificate even if it isn't active?
      - Is there a way to get back the PEM content of a certificate I uploaded?
      instructions:
      - text: Get certificate {certificate_id}.
        slots:
          certificate_id: path.certificate_id
      - text: Fetch certificate {certificate_id} including {include}.
        slots:
          certificate_id: path.certificate_id
          include: query.include
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/certificates/{certificate_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename a certificate
      effect: write
      questions:
      - Can I rename a certificate after uploading it?
      - What can I change on an uploaded certificate besides its name?
      instructions:
      - text: Rename certificate {certificate_id} to {name}.
        slots:
          certificate_id: path.certificate_id
          name: requestBody.name
      - text: Change the display name of certificate {certificate_id} to {name}.
        slots:
          certificate_id: path.certificate_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/certificates/{certificate_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate
      effect: destructive
      questions:
      - Why can't I delete a certificate that is still active?
      - How do I remove a certificate from my organization entirely?
      instructions:
      - text: Delete certificate {certificate_id}.
        slots:
          certificate_id: path.certificate_id
      - text: Remove the inactive certificate {certificate_id} from my organization.
        slots:
          certificate_id: path.certificate_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/projects/{project_id}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project's certificates
      effect: read
      questions:
      - Which certificates are active for a particular project?
      - Can I see the certificates configured on one project only?
      instructions:
      - text: List the certificates for project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show the first {limit} certificates on project {project_id}.
        slots:
          limit: query.limit
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/projects/{project_id}/certificates/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate certificates for a project
      effect: write
      questions:
      - Can I enable certificates for just one project instead of the whole org?
      - What's the limit on certificates I can activate on a project in one call?
      instructions:
      - text: Activate certificates {certificate_ids} on project {project_id}.
        slots:
          certificate_ids: requestBody.certificate_ids
          project_id: path.project_id
      - text: Turn on certificates {certificate_ids} for project {project_id} only.
        slots:
          certificate_ids: requestBody.certificate_ids
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/projects/{project_id}/certificates/deactivate'].post
  update:
    x-apievangelist-phrasing:
      intent: Deactivate certificates for a project
      effect: write
      questions:
      - Can I switch off a certificate for one project but leave it active elsewhere?
      - How many certificates can I deactivate on a single project at a time?
      instructions:
      - text: Deactivate certificates {certificate_ids} on project {project_id}.
        slots:
          certificate_ids: requestBody.certificate_ids
          project_id: path.project_id
      - text: Turn off certificates {certificate_ids} for project {project_id} only.
        slots:
          certificate_ids: requestBody.certificate_ids
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'