# 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 Reference API
  version: 1.0.0
extends: openapi/clarivate-reference-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['/reference/types'].get
  update:
    x-apievangelist-phrasing:
      intent: List all EndNote reference types
      effect: read
      questions:
      - Which reference types does EndNote support, like journal article or book?
      - How do I get the full collection of reference types?
      instructions:
      - text: List all EndNote reference types.
      - text: Retrieve every reference type as {format}.
        slots:
          format: header.Accept
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reference'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reference by GUID header
      effect: read
      questions:
      - How do I get a reference's current state when I have its GUID but not its URI?
      - Can I read an EndNote reference using the x-enws-guid header?
      instructions:
      - text: Get the reference identified by the GUID header.
      - text: Retrieve the current state of a reference by GUID as {format}.
        slots:
          format: header.Accept
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reference'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a reference identified in the body
      effect: write
      questions:
      - How do I update an EndNote reference when I only have its GUID in the payload?
      - What happens if the update sequence number is stale when I edit a reference?
      instructions:
      - text: Update reference {guid} with bibliographic fields {biblioContent} at sequence {updateSequenceNum}.
        slots:
          guid: requestBody.guid
          biblioContent: requestBody.biblioContent
          updateSequenceNum: requestBody.updateSequenceNum
      - text: Change the title fields {biblioContent} on reference {guid} without its URI.
        slots:
          guid: requestBody.guid
          biblioContent: requestBody.biblioContent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reference'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an EndNote reference
      effect: write
      questions:
      - How do I add a new reference to my EndNote library?
      - What is the minimum I need to send to create a reference?
      instructions:
      - text: Create a reference with fields {biblioContent}.
        slots:
          biblioContent: requestBody.biblioContent
      - text: Add a new EndNote reference whose bibliographic content is {biblioContent}.
        slots:
          biblioContent: requestBody.biblioContent
      method: generated
      generated: '2026-09-26'