# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Converis Web Services Administration - User Delegations API
  version: 1.0.0
extends: openapi/clarivate-administration-user-delegations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/admin/users/delegation'].get
  update:
    x-apievangelist-phrasing:
      intent: Find user delegations
      effect: read
      questions:
      - How do I see which Converis users have delegated their roles to someone else?
      - Can I look up delegations made by a specific user?
      - Which delegations are active between two dates?
      instructions:
      - text: Get delegation {delegationId}.
        slots:
          delegationId: query.delegationId
      - text: List delegations created by {fromUserName}.
        slots:
          fromUserName: query.fromUserName
      - text: Show delegations for role {roleName} valid from {startDate} to {endDate}.
        slots:
          roleName: query.roleName
          startDate: query.startDate
          endDate: query.endDate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/users/delegation'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a user delegation
      effect: write
      questions:
      - How do I extend or change an existing role delegation?
      - Can I change who receives a delegation after it was set up?
      instructions:
      - text: Update delegation {delegationId} so it is valid for {validity}.
        slots:
          delegationId: requestBody.delegationId
          validity: requestBody.validity
      - text: Change existing delegation {delegationId} to hand role {role} to {toUser}.
        slots:
          delegationId: requestBody.delegationId
          role: requestBody.role
          toUser: requestBody.toUser
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/users/delegation'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user delegation
      effect: write
      questions:
      - How do I let one Converis user act in another user's role while they are away?
      - What do I need to set up a new role delegation?
      instructions:
      - text: Delegate role {role} from {fromUser} to {toUser}.
        slots:
          role: requestBody.role
          fromUser: requestBody.fromUser
          toUser: requestBody.toUser
      - text: Set up a new delegation of {role} from {fromUser} to {toUser} for {validity}.
        slots:
          role: requestBody.role
          fromUser: requestBody.fromUser
          toUser: requestBody.toUser
          validity: requestBody.validity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/users/delegation{delegation_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user delegation
      effect: destructive
      questions:
      - How do I revoke a role delegation in Converis?
      - Can I cancel a delegation before it expires?
      instructions:
      - text: Delete delegation {delegation_id}.
        slots:
          delegation_id: path.delegation_id
      - text: Revoke user delegation {delegation_id} now.
        slots:
          delegation_id: path.delegation_id
      method: generated
      generated: '2026-10-01'