# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for EndNote REST References API
  version: 1.0.0
extends: openapi/clarivate-references-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: 3
- target: $.paths['/references/{guid}/file'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a file to a reference
      effect: write
      questions:
      - How do I attach a PDF to an existing EndNote reference?
      - What checksum and name headers are needed when uploading a reference attachment?
      instructions:
      - text: Attach a file to reference {guid}.
        slots:
          guid: path.guid
      - text: Upload this attachment onto EndNote reference {guid}.
        slots:
          guid: path.guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/references/{guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reference by its GUID path
      effect: read
      questions:
      - How do I read all fields of a specific reference by its URI?
      - Can I request a reference's content in a format other than JSON?
      instructions:
      - text: Get the fields of reference {guid}.
        slots:
          guid: path.guid
      - text: Retrieve reference {guid} in {format} format.
        slots:
          guid: path.guid
          format: header.Accept
      method: generated
      generated: '2026-09-26'
- target: $.paths['/references/{guid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a reference at its URI
      effect: write
      questions:
      - How do I change bibliographic fields on a reference I address by its URI?
      - What if the reference was changed in another application before my update?
      instructions:
      - text: Update reference {guid} at its URI with fields {biblioContent}.
        slots:
          guid: path.guid
          biblioContent: requestBody.biblioContent
      - text: Set the bibliographic content of reference {guid} to {biblioContent} using sequence {seq}.
        slots:
          guid: path.guid
          biblioContent: requestBody.biblioContent
          seq: requestBody.updateSequenceNum
      method: generated
      generated: '2026-09-26'