# 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 Reservedtime API
  version: 1.0.0
extends: openapi/adobe-suite-reservedtime-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['/reservedtime/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one reserved time block
      effect: read
      questions:
      - What does a single reserved time record show about a user's blocked-off time?
      - Can I fetch one reserved time entry by ID?
      instructions:
      - text: Show reserved time {id}.
        slots:
          id: path.id
      - text: Get reserved time {id} with {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a reserved time block
      effect: write
      questions:
      - How do I change the dates of someone's reserved time?
      - Can I update one reserved time entry?
      instructions:
      - text: Update reserved time {id} with my changes.
        slots:
          id: path.id
      - text: Edit reserved time {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a reserved time block
      effect: destructive
      questions:
      - Can I cancel a user's reserved time off?
      - Is there a force flag when deleting reserved time?
      instructions:
      - text: Delete reserved time {id}.
        slots:
          id: path.id
      - text: Force delete reserved time {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several reserved time blocks
      effect: read
      questions:
      - Can I pull multiple reserved time records at once by ID?
      - Which fields can I choose when fetching a batch of reserved times?
      instructions:
      - text: Get reserved times {id}.
        slots:
          id: query.id
      - text: Fetch reserved times {id} with fields {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk edit reserved time
      effect: write
      questions:
      - Can I update several reserved time entries in one request?
      - Is there a bulk edit for reserved time?
      instructions:
      - text: Bulk edit these reserved time entries with my changes.
      - text: Update several reserved times together and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime'].post
  update:
    x-apievangelist-phrasing:
      intent: Reserve time for a user
      effect: write
      questions:
      - How do I block out time for a user so they are not scheduled?
      - Can I create reserved time through the API?
      instructions:
      - text: Create reserved time with the dates and user I give you.
      - text: Add a reserved time block and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several reserved time blocks
      effect: destructive
      questions:
      - Can I bulk delete reserved time entries?
      - How do I remove multiple reserved time blocks at once?
      instructions:
      - text: Delete reserved times {id}.
        slots:
          id: query.id
      - text: Force delete reserved times {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count reserved time entries
      effect: read
      questions:
      - How many reserved time entries exist?
      - Can I count reserved time that matches a filter?
      instructions:
      - text: Count all reserved time entries.
      - text: Count reserved times matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search reserved time
      effect: read
      questions:
      - Which users have reserved time next month?
      - Can I search reserved time with filters and list options?
      instructions:
      - text: Search reserved time where {filters}.
        slots:
          filters: query.filters
      - text: Find reserved times matching {filters} with list options {listOptions}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reservedtime/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report over reserved time
      effect: read
      questions:
      - Can I get a summarized report of reserved time?
      - What does a reserved time report return?
      instructions:
      - text: Run a reserved time report.
      - text: Report on reserved time filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'