# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hubdb Tables API
  version: 1.0.0
extends: openapi/hubspot-tables-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: 16
- target: $.paths['/cms/v3/hubdb/2026-09/tables'].get
  update:
    x-apievangelist-phrasing:
      intent: List all published HubDB tables
      effect: read
      questions:
      - Which HubDB tables are live on my site right now, with their columns?
      - Can I list only the published tables updated after a certain date?
      - How do I see the published HubDB tables I archived?
      instructions:
      - text: List every published HubDB table in my account with its column definitions.
      - text: Show published HubDB tables updated after {updatedAfter}, {limit} per page.
        slots:
          updatedAfter: query.updatedAfter
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new HubDB table
      effect: write
      questions:
      - How do I create a new HubDB table with my own columns?
      - Can a new HubDB table be readable publicly without authorization?
      - Does a HubDB table name have to be unique in my account?
      instructions:
      - text: Create a HubDB table named {name} labeled {label} with columns {columns}.
        slots:
          name: requestBody.name
          label: requestBody.label
          columns: requestBody.columns
      - text: 'Create a new HubDB table {name} that can be used for dynamic pages: {useForPages}.'
        slots:
          name: requestBody.name
          useForPages: requestBody.useForPages
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/draft'].get
  update:
    x-apievangelist-phrasing:
      intent: List all draft HubDB tables
      effect: read
      questions:
      - What unpublished draft HubDB tables exist in my account?
      - Can I list draft tables created before a given date?
      instructions:
      - text: List every draft HubDB table in my account, including unpublished changes.
      - text: Show draft HubDB tables created after {createdAfter}.
        slots:
          createdAfter: query.createdAfter
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a published HubDB table's details
      effect: read
      questions:
      - How many rows does my published HubDB table have and what are its columns?
      - Can the published version of a public HubDB table be read without authentication?
      instructions:
      - text: Get the published version of HubDB table {tableIdOrName} with its column definitions and row count.
        slots:
          tableIdOrName: path.tableIdOrName
      - text: Show the live schema of table {tableIdOrName} including foreign IDs.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Archive a HubDB table
      effect: destructive
      questions:
      - How do I archive a HubDB table I no longer use?
      - Does archiving a HubDB table remove both its draft and published versions?
      instructions:
      - text: Archive HubDB table {tableIdOrName}, both draft and published.
        slots:
          tableIdOrName: path.tableIdOrName
      - text: Soft delete the table {tableIdOrName}.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/draft'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a draft HubDB table's details
      effect: read
      questions:
      - What columns does the draft version of my HubDB table have before I publish?
      - How many rows are in the draft copy of a table?
      instructions:
      - text: Get the draft version of HubDB table {tableIdOrName} with its columns and row count.
        slots:
          tableIdOrName: path.tableIdOrName
      - text: Show me the unpublished schema of table {tableIdOrName}.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/draft'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a draft HubDB table's schema
      effect: write
      questions:
      - How do I add or remove columns on an existing HubDB table?
      - Can I restore an archived HubDB table?
      - Do schema edits go live immediately or only to the draft?
      instructions:
      - text: Update the draft of table {tableIdOrName} to use columns {columns}.
        slots:
          tableIdOrName: path.tableIdOrName
          columns: requestBody.columns
      - text: Rename the label of existing table {tableIdOrName} to {label} in its draft.
        slots:
          tableIdOrName: path.tableIdOrName
          label: requestBody.label
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/draft/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a HubDB table
      effect: write
      questions:
      - Can I duplicate an existing HubDB table under a new name?
      - Does cloning a table copy its rows or just the structure?
      instructions:
      - text: 'Clone table {tableIdOrName} as {newName}, copying rows: {copyRows}.'
        slots:
          tableIdOrName: path.tableIdOrName
          newName: requestBody.newName
          copyRows: requestBody.copyRows
      - text: Make a draft copy of table {tableIdOrName} labeled {newLabel}.
        slots:
          tableIdOrName: path.tableIdOrName
          newLabel: requestBody.newLabel
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/draft/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export a draft HubDB table
      effect: read
      questions:
      - Can I download my unpublished HubDB table changes as a spreadsheet?
      - What formats can a draft table be exported in?
      instructions:
      - text: Export the draft of table {tableIdOrName} as {format}.
        slots:
          tableIdOrName: path.tableIdOrName
          format: query.format
      - text: Download the draft version of table {tableIdOrName} to CSV.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/draft/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import CSV data into a HubDB table
      effect: write
      questions:
      - How do I bulk load rows into a HubDB table from a CSV file?
      - Does a CSV import go straight to the live table?
      instructions:
      - text: Import {file} into the draft of table {tableIdOrName}.
        slots:
          file: requestBody.file
          tableIdOrName: path.tableIdOrName
      - text: Load CSV {file} into table {tableIdOrName} using import config {config}.
        slots:
          file: requestBody.file
          tableIdOrName: path.tableIdOrName
          config: requestBody.config
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/draft/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a HubDB table's draft
      effect: write
      questions:
      - How do I push my draft HubDB changes live so website pages update?
      - Will publishing a table update the pages that use its data?
      instructions:
      - text: Publish the draft of table {tableIdOrName} to the live version.
        slots:
          tableIdOrName: path.tableIdOrName
      - text: Make the pending schema and row changes on {tableIdOrName} go live.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/draft/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Discard draft changes to a HubDB table
      effect: destructive
      questions:
      - How do I throw away unpublished edits and go back to the live table?
      - Are draft changes lost when I reset a HubDB table?
      instructions:
      - text: Reset the draft of table {tableIdOrName} to match the published version.
        slots:
          tableIdOrName: path.tableIdOrName
      - text: Discard all unpublished changes on table {tableIdOrName}.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export a published HubDB table
      effect: read
      questions:
      - Can I download the live version of a HubDB table as a file?
      - Which format should I pick to export a published table to Excel?
      instructions:
      - text: Export the published version of table {tableIdOrName} as {format}.
        slots:
          tableIdOrName: path.tableIdOrName
          format: query.format
      - text: Download the live data of table {tableIdOrName}.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/draft'].get
  update:
    x-apievangelist-phrasing:
      intent: Get rows from a draft HubDB table
      effect: read
      questions:
      - How do I read the rows in my HubDB table's draft before publishing?
      - Can I filter and sort draft table rows by a column value?
      instructions:
      - text: Get the draft rows of table {tableIdOrName}, {limit} at a time.
        slots:
          tableIdOrName: path.tableIdOrName
          limit: query.limit
      - text: List draft rows in table {tableIdOrName} sorted by {sort}.
        slots:
          tableIdOrName: path.tableIdOrName
          sort: query.sort
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/unpublish'].post
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a HubDB table
      effect: destructive
      questions:
      - What happens to my website pages if I unpublish a HubDB table?
      - How do I take a HubDB table offline without archiving it?
      instructions:
      - text: Unpublish table {tableIdOrName} so pages stop rendering its data.
        slots:
          tableIdOrName: path.tableIdOrName
      - text: Take HubDB table {tableIdOrName} off the live site.
        slots:
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/versions/{versionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a specific HubDB table version
      effect: destructive
      questions:
      - Can I remove one old version of a HubDB table?
      - Is deleting a single table version different from archiving the whole table?
      instructions:
      - text: Delete version {versionId} of table {tableIdOrName}.
        slots:
          versionId: path.versionId
          tableIdOrName: path.tableIdOrName
      - text: Remove table version {versionId} from HubDB table {tableIdOrName}.
        slots:
          versionId: path.versionId
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'