# 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 Microsoft Code Transparency Service Entries…
  version: 1.0.0
extends: openapi/microsoft-azure-entries-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: 4
- target: $.paths['/entries'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an entry on a Code Transparency ledger
      effect: write
      questions:
      - How do I register a signed statement on my Code Transparency service?
      - Can I submit a COSE-signed entry to be recorded on the transparency ledger?
      instructions:
      - text: Register entry {entry} on the Code Transparency instance.
        slots:
          entry: body.body
      - text: Submit this signed statement {entry} to the transparency ledger.
        slots:
          entry: body.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/entries/{entryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a transparency ledger entry
      effect: read
      questions:
      - Can I fetch a registered transparency entry with its receipt embedded?
      - What does a specific Code Transparency entry contain?
      instructions:
      - text: Get Code Transparency entry {entry_id}.
        slots:
          entry_id: path.entryId
      - text: Fetch entry {entry_id} with the receipt embedded set to {embed}.
        slots:
          entry_id: path.entryId
          embed: query.embedReceipt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/entries/{entryId}/receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the receipt for a transparency entry
      effect: read
      questions:
      - Where do I get the proof-of-inclusion receipt for a registered entry?
      - Can I download just the receipt of a Code Transparency entry?
      instructions:
      - text: Get the receipt for entry {entry_id}.
        slots:
          entry_id: path.entryId
      - text: Download only the inclusion receipt of transparency entry {entry_id}.
        slots:
          entry_id: path.entryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/entries/txIds'].get
  update:
    x-apievangelist-phrasing:
      intent: List ledger entry ids in a transaction range
      effect: read
      questions:
      - Which entries were registered between two transaction ids?
      - Can I query historical Code Transparency entries over a range?
      instructions:
      - text: List entry ids from transaction {from} to {to}.
        slots:
          from: query.from
          to: query.to
      - text: Show all historical transparency entries registered so far.
      method: generated
      generated: '2026-09-26'