# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Social Drafts API
  version: 1.0.0
extends: openapi/vendasta-drafts-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: 8
- target: $.paths['/v1/social-drafts/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a social post draft
      effect: write
      questions:
      - How do I save a social media post as a draft instead of publishing it?
      - Can a draft be set with a planned post time and media attached?
      instructions:
      - text: Create a draft for account {account} with text {text}.
        slots:
          account: requestBody.accountGroupId
          text: requestBody.draftText
      - text: Save a draft for account {account} saying {text}, planned for {when}.
        slots:
          account: requestBody.accountGroupId
          text: requestBody.draftText
          when: requestBody.postDateTime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/social-drafts/create-multi'].post
  update:
    x-apievangelist-phrasing:
      intent: Save several social drafts at once
      effect: write
      questions:
      - Can I create a batch of social post drafts in one request?
      - Is there a bulk way to add drafts for multiple accounts?
      instructions:
      - text: 'Create these drafts in bulk: {drafts}.'
        slots:
          drafts: requestBody.drafts
      - text: Save the batch of social drafts {drafts} in one go.
        slots:
          drafts: requestBody.drafts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/social-drafts/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a social post draft
      effect: destructive
      questions:
      - Can I throw away a social draft I no longer need?
      - What's needed to remove a single draft from an account?
      instructions:
      - text: Delete draft {draft} from account {account}.
        slots:
          draft: requestBody.draftId
          account: requestBody.accountGroupId
      - text: Remove social draft {draft} for account {account}.
        slots:
          draft: requestBody.draftId
          account: requestBody.accountGroupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/social-drafts/delete-multi'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete multi-location drafts for a brand
      effect: destructive
      questions:
      - How can I clear out several multi-location drafts for a brand at once?
      - Can brand-level drafts be deleted in bulk?
      instructions:
      - text: Delete multi-location drafts {drafts} for brand {brand}.
        slots:
          drafts: requestBody.mlDraftPosts
          brand: requestBody.brandId
      - text: Remove brand {brand}'s multi-location draft posts {drafts}.
        slots:
          brand: requestBody.brandId
          drafts: requestBody.mlDraftPosts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/social-drafts/get'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a social post draft
      effect: read
      questions:
      - What does a particular saved draft contain?
      - Can I open one draft to review its text and media?
      instructions:
      - text: Get draft {draft} for account {account}.
        slots:
          draft: requestBody.draftId
          account: requestBody.accountGroupId
      - text: Show the contents of social draft {draft} on account {account}.
        slots:
          draft: requestBody.draftId
          account: requestBody.accountGroupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/social-drafts/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List an account's social drafts
      effect: read
      questions:
      - Which social drafts are waiting on an account?
      - Can I filter drafts by social network or date range?
      - Is there a search for drafts by their text?
      instructions:
      - text: List drafts for account {account}.
        slots:
          account: requestBody.accountGroupId
      - text: Show drafts for account {account} between {start} and {end}.
        slots:
          account: requestBody.accountGroupId
          start: requestBody.start
          end: requestBody.end
      - text: Find drafts on account {account} containing {term}.
        slots:
          account: requestBody.accountGroupId
          term: requestBody.searchTerm
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/social-drafts/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit a social post draft
      effect: write
      questions:
      - Can I change the text or scheduled time of a draft I already saved?
      - Is it possible to swap the media on an existing draft?
      instructions:
      - text: Change the text of draft {draft} on account {account} to {text}.
        slots:
          draft: requestBody.draftId
          account: requestBody.accountGroupId
          text: requestBody.draftText
      - text: Move draft {draft} for account {account} to post at {when}.
        slots:
          draft: requestBody.draftId
          account: requestBody.accountGroupId
          when: requestBody.postDateTime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/social-drafts/update-multi'].post
  update:
    x-apievangelist-phrasing:
      intent: Update several multi-location drafts
      effect: write
      questions:
      - Can I edit a set of multi-location drafts together?
      - Is there a bulk update for brand drafts?
      instructions:
      - text: 'Update these multi-location drafts: {drafts}.'
        slots:
          drafts: requestBody.drafts
      - text: Apply the edits {drafts} to my brand's multi-location drafts.
        slots:
          drafts: requestBody.drafts
      method: generated
      generated: '2026-10-01'