# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hubspot Revisions API
  version: 1.0.0
extends: openapi/hubspot-revisions-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/automation/actions/2026-09/{appId}/{definitionId}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a custom workflow action
      effect: read
      questions:
      - How do I see the version history of a custom workflow action my app defines?
      - Can I page through every revision of a workflow action definition?
      instructions:
      - text: List the revisions of action definition {definitionId} in app {appId}.
        slots:
          definitionId: path.definitionId
          appId: path.appId
      - text: Show the latest {limit} versions of workflow action {definitionId} for app {appId}.
        slots:
          limit: query.limit
          definitionId: path.definitionId
          appId: path.appId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/automation/actions/2026-09/{appId}/{definitionId}/revisions/{revisionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one version of a custom workflow action
      effect: read
      questions:
      - What did my custom workflow action look like in a specific earlier revision?
      - Can I fetch a single action definition revision by its ID?
      instructions:
      - text: Get revision {revisionId} of action definition {definitionId} in app {appId}.
        slots:
          revisionId: path.revisionId
          definitionId: path.definitionId
          appId: path.appId
      - text: Show workflow action {definitionId} from app {appId} as of revision {revisionId}.
        slots:
          definitionId: path.definitionId
          appId: path.appId
          revisionId: path.revisionId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/{objectId}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List previous versions of a blog post
      effect: read
      questions:
      - Where can I find the edit history of a HubSpot blog post?
      - Can I list every earlier version of one blog post?
      instructions:
      - text: List all previous versions of blog post {objectId}.
        slots:
          objectId: path.objectId
      - text: Show the last {limit} revisions of blog post {objectId}.
        slots:
          limit: query.limit
          objectId: path.objectId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/{objectId}/revisions/{revisionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: View one previous version of a blog post
      effect: read
      questions:
      - How do I read exactly what a blog post said in an older revision?
      - Can I open a specific past version of a post to compare it with the current one?
      instructions:
      - text: Get revision {revisionId} of blog post {objectId}.
        slots:
          revisionId: path.revisionId
          objectId: path.objectId
      - text: Show blog post {objectId} as it was in version {revisionId}.
        slots:
          objectId: path.objectId
          revisionId: path.revisionId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/{objectId}/revisions/{revisionId}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a blog post to an earlier version
      effect: write
      questions:
      - How do I roll a blog post back to how it looked before recent edits?
      - Can I undo changes to a published post by restoring an old revision?
      instructions:
      - text: Restore blog post {objectId} to revision {revisionId}.
        slots:
          objectId: path.objectId
          revisionId: path.revisionId
      - text: Roll back post {objectId} to its earlier version {revisionId}.
        slots:
          objectId: path.objectId
          revisionId: path.revisionId
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/blogs/2026-09/posts/{objectId}/revisions/{revisionId}/restore-to-draft'].post
  update:
    x-apievangelist-phrasing:
      intent: Make an old blog post version the new draft
      effect: write
      questions:
      - Can I bring back an old version of a blog post as a draft to rework it before publishing?
      - Is there a way to start a new draft from an earlier revision of a post?
      instructions:
      - text: Set revision {revisionId} of blog post {objectId} as its new draft.
        slots:
          revisionId: path.revisionId
          objectId: path.objectId
      - text: Load old version {revisionId} of post {objectId} into the draft without publishing it.
        slots:
          revisionId: path.revisionId
          objectId: path.objectId
      method: generated
      generated: '2026-09-24'