# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Workfront Externalauthtoken API
  version: 1.0.0
extends: openapi/adobe-suite-externalauthtoken-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['/externalauthtoken/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one external auth token
      effect: read
      questions:
      - How do I inspect a single stored external authentication token in Workfront?
      - Can I choose which fields return for one external auth token?
      instructions:
      - text: Show external auth token {id}.
        slots:
          id: path.id
      - text: Get external token {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one external auth token
      effect: write
      questions:
      - Can I update the details stored on an existing external auth token?
      - What's the call to edit a single external authentication token?
      instructions:
      - text: Edit external auth token {id} with the values I give you.
        slots:
          id: path.id
      - text: Update external token {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one external auth token
      effect: destructive
      questions:
      - How do I remove a stored external authentication token?
      - Is there a force flag when deleting one external auth token?
      instructions:
      - text: Delete external auth token {id}.
        slots:
          id: path.id
      - text: Remove external token {id} with force {force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several external auth tokens by ID
      effect: read
      questions:
      - Can I retrieve multiple external auth tokens in one call by ID?
      - Which call returns a batch of known external tokens?
      instructions:
      - text: Fetch external auth tokens {id}.
        slots:
          id: query.id
      - text: Get external tokens {id} showing only {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken'].put
  update:
    x-apievangelist-phrasing:
      intent: Update many external auth tokens at once
      effect: write
      questions:
      - Can I bulk edit several external auth tokens in one request?
      - What updates a group of external tokens together?
      instructions:
      - text: Apply these edits to all the external auth tokens I list.
      - text: Bulk update the external tokens and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken'].post
  update:
    x-apievangelist-phrasing:
      intent: Store a new external auth token
      effect: write
      questions:
      - How do I save a new external authentication token for an integration?
      - What do I send to create an external auth token record?
      instructions:
      - text: Create an external auth token with the details I provide.
      - text: Add a new external token and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many external auth tokens at once
      effect: destructive
      questions:
      - Can I bulk delete external auth tokens by listing their IDs?
      - What clears out several external tokens in a single call?
      instructions:
      - text: Bulk delete external auth tokens {id}.
        slots:
          id: query.id
      - text: Remove every external token in {id} using force {force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count external auth tokens
      effect: read
      questions:
      - How many external auth tokens match a given filter?
      - Can I get just the total of stored external tokens?
      instructions:
      - text: Count external auth tokens where {filters}.
        slots:
          filters: query.filters
      - text: Tell me how many external tokens are stored.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search external auth tokens
      effect: read
      questions:
      - What's the way to find external auth tokens for a given user or provider?
      - Can I search external tokens with paging and sorting?
      instructions:
      - text: Search external auth tokens matching {filters}.
        slots:
          filters: query.filters
      - text: Find external tokens where {filters} and list {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalauthtoken/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report on external auth tokens
      effect: read
      questions:
      - Can I get grouped totals of external tokens as a report?
      - Which call gives a report-style summary of external auth tokens?
      instructions:
      - text: Run an external auth token report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Summarize external tokens as a report with {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'