# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign REST User Signatures API
  version: 1.0.0
extends: openapi/docusign-usersignatures-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: 9
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's saved signatures
      effect: read
      questions:
      - Which signature styles has a user saved on their account?
      - Can I list only a user's stamps rather than signatures?
      instructions:
      - text: List the signatures saved for user {userId}.
        slots:
          userId: path.userId
      - text: Show user {userId}'s signatures in account {accountId} of stamp type {stamp_type}.
        slots:
          userId: path.userId
          accountId: path.accountId
          stamp_type: query.stamp_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update a user's signatures in bulk
      effect: write
      questions:
      - Can I add or replace several of a user's signatures in one request?
      - Is there a single call to update the whole set of a user's signatures?
      instructions:
      - text: Update the signature set of user {userId} to {userSignatures}.
        slots:
          userId: path.userId
          userSignatures: requestBody.userSignatures
      - text: Add or update signatures for user {userId} in account {accountId}.
        slots:
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures'].post
  update:
    x-apievangelist-phrasing:
      intent: Add signature and initials images for a user
      effect: write
      questions:
      - Can I upload a new signature image and initials image for a user?
      - Does the user have to be the authenticated user to add a signature for them?
      instructions:
      - text: Add new signature {userSignatures} for user {userId}.
        slots:
          userSignatures: requestBody.userSignatures
          userId: path.userId
      - text: Create a signature with signature and initials images for user {userId} in account {accountId}.
        slots:
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of a user's signatures
      effect: read
      questions:
      - Can I look up a single user signature by its ID or name?
      - What does the structure of one saved signature look like?
      instructions:
      - text: Get signature {signatureId} for user {userId}.
        slots:
          signatureId: path.signatureId
          userId: path.userId
      - text: Show the details of user {userId}'s signature {signatureId} in account {accountId}.
        slots:
          userId: path.userId
          signatureId: path.signatureId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a signature's font, name or initials
      effect: write
      questions:
      - Can I change the font used for a user's adopted signature?
      - Does updating a signature by ID create a default signature when none exists?
      instructions:
      - text: Set signature {signatureId} of user {userId} to font {signatureFont}.
        slots:
          signatureId: path.signatureId
          userId: path.userId
          signatureFont: requestBody.signatureFont
      - text: Rename signature {signatureId} for user {userId} in account {accountId} to {signatureName} with initials {signatureInitials}.
        slots:
          signatureId: path.signatureId
          userId: path.userId
          accountId: path.accountId
          signatureName: requestBody.signatureName
          signatureInitials: requestBody.signatureInitials
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user's signature
      effect: destructive
      questions:
      - Can I delete a saved signature from a user's account?
      - Should I identify the signature to remove by ID or by name?
      instructions:
      - text: Delete signature {signatureId} from user {userId}.
        slots:
          signatureId: path.signatureId
          userId: path.userId
      - text: Remove user {userId}'s signature {signatureId} in account {accountId}.
        slots:
          userId: path.userId
          signatureId: path.signatureId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}/{imageType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a signature or initials image
      effect: read
      questions:
      - Can I download the actual image of a user's signature or initials?
      - Is it possible to get the signature image with or without the surrounding chrome?
      instructions:
      - text: Download the {imageType} image of signature {signatureId} for user {userId}.
        slots:
          imageType: path.imageType
          signatureId: path.signatureId
          userId: path.userId
      - text: Get the {imageType} for signature {signatureId} of user {userId} in account {accountId} with chrome.
        slots:
          imageType: path.imageType
          signatureId: path.signatureId
          userId: path.userId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}/{imageType}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a new signature or initials image
      effect: write
      questions:
      - What image formats and file size are allowed for a signature image?
      - Can I replace just the initials image of an existing signature?
      instructions:
      - text: Replace the {imageType} image of signature {signatureId} for user {userId}.
        slots:
          imageType: path.imageType
          signatureId: path.signatureId
          userId: path.userId
      - text: Upload a new {imageType} for user {userId}'s signature {signatureId} in account {accountId}.
        slots:
          imageType: path.imageType
          userId: path.userId
          signatureId: path.signatureId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/users/{userId}/signatures/{signatureId}/{imageType}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a signature or initials image
      effect: destructive
      questions:
      - Can I delete just the initials image from a signature and keep the rest?
      - Do I need two calls to remove both the signature image and the initials image?
      instructions:
      - text: Delete the {imageType} image from signature {signatureId} of user {userId}.
        slots:
          imageType: path.imageType
          signatureId: path.signatureId
          userId: path.userId
      - text: Erase only the {imageType} picture on signature {signatureId} of user {userId} in account {accountId}.
        slots:
          userId: path.userId
          imageType: path.imageType
          signatureId: path.signatureId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'