# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hubdb Rows API
  version: 1.0.0
extends: openapi/hubspot-rows-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: 15
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows'].get
  update:
    x-apievangelist-phrasing:
      intent: List rows in a published HubDB table
      effect: read
      questions:
      - How do I read all the rows of a published HubDB table?
      - Can I filter and sort HubDB rows by a column value when listing them?
      - Is there a page size limit when pulling rows from a live HubDB table?
      instructions:
      - text: List the rows in the published HubDB table {tableIdOrName}.
        slots:
          tableIdOrName: path.tableIdOrName
      - text: Get the first {limit} live rows of table {tableIdOrName}, sorted by {sort}.
        slots:
          limit: query.limit
          tableIdOrName: path.tableIdOrName
          sort: query.sort
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows'].post
  update:
    x-apievangelist-phrasing:
      intent: Add one row to a HubDB table
      effect: write
      questions:
      - How do I add a single new row to a HubDB table?
      - Do new rows show up right away, or do I have to publish the table first?
      - Can I set the page title and URL slug for a dynamic page when adding a row?
      instructions:
      - text: Add a row to HubDB table {tableIdOrName} with the column values {values}.
        slots:
          tableIdOrName: path.tableIdOrName
          values: requestBody.values
      - text: Insert one row into table {tableIdOrName} with slug {path} and title {name}.
        slots:
          tableIdOrName: path.tableIdOrName
          path: requestBody.path
          name: requestBody.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/batch/read'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch several published HubDB rows by ID
      effect: read
      questions:
      - Can I pull a specific set of live HubDB rows by their IDs in one request?
      - Does batch-reading rows from a public HubDB table need authentication?
      instructions:
      - text: Get the published rows {inputs} from HubDB table {tableIdOrName}.
        slots:
          inputs: requestBody.inputs
          tableIdOrName: path.tableIdOrName
      - text: 'Look up these live row IDs in table {tableIdOrName}: {inputs}.'
        slots:
          tableIdOrName: path.tableIdOrName
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/draft/batch/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone many HubDB rows at once
      effect: write
      questions:
      - How many HubDB rows can I duplicate in a single call?
      - Can I copy a batch of rows in a table's draft to use as templates?
      instructions:
      - text: Clone rows {inputs} in the draft of HubDB table {tableIdOrName}.
        slots:
          inputs: requestBody.inputs
          tableIdOrName: path.tableIdOrName
      - text: 'Duplicate this batch of row IDs in table {tableIdOrName}: {inputs}.'
        slots:
          tableIdOrName: path.tableIdOrName
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/draft/batch/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk add rows to a HubDB table draft
      effect: write
      questions:
      - What's the fastest way to load a lot of new rows into HubDB?
      - Is there a cap on how many rows I can create in one batch request?
      instructions:
      - text: 'Create these rows in bulk in the draft of HubDB table {tableIdOrName}: {inputs}.'
        slots:
          tableIdOrName: path.tableIdOrName
          inputs: requestBody.inputs
      - text: Batch insert up to 100 new rows {inputs} into table {tableIdOrName}.
        slots:
          inputs: requestBody.inputs
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/draft/batch/purge'].post
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete many HubDB rows
      effect: destructive
      questions:
      - How do I delete a batch of rows from a HubDB table for good?
      - Can deleted HubDB rows be recovered after a bulk purge?
      instructions:
      - text: Permanently delete rows {inputs} from the draft of table {tableIdOrName}.
        slots:
          inputs: requestBody.inputs
          tableIdOrName: path.tableIdOrName
      - text: 'Purge this batch of row IDs from HubDB table {tableIdOrName}: {inputs}.'
        slots:
          tableIdOrName: path.tableIdOrName
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/draft/batch/read'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch several draft HubDB rows by ID
      effect: read
      questions:
      - Can I read a set of unpublished rows from a HubDB table's draft by ID?
      - How do I check pending row edits for several rows before publishing the table?
      instructions:
      - text: Get draft rows {inputs} from HubDB table {tableIdOrName}.
        slots:
          inputs: requestBody.inputs
          tableIdOrName: path.tableIdOrName
      - text: 'Show the unpublished versions of these rows in table {tableIdOrName}: {inputs}.'
        slots:
          tableIdOrName: path.tableIdOrName
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/draft/batch/replace'].post
  update:
    x-apievangelist-phrasing:
      intent: Overwrite many HubDB rows at once
      effect: write
      questions:
      - Can I fully replace the contents of many HubDB rows in one request?
      - What's the maximum number of rows I can overwrite per batch call?
      instructions:
      - text: 'Replace these rows wholesale in the draft of table {tableIdOrName}: {inputs}.'
        slots:
          tableIdOrName: path.tableIdOrName
          inputs: requestBody.inputs
      - text: Batch overwrite rows {inputs} in HubDB table {tableIdOrName}, replacing every column.
        slots:
          inputs: requestBody.inputs
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/draft/batch/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Partially update many HubDB rows at once
      effect: write
      questions:
      - How do I change a few column values across many HubDB rows at once?
      - Can I bulk edit rows without resending every column?
      instructions:
      - text: 'Batch update rows in the draft of table {tableIdOrName} with these changes: {inputs}.'
        slots:
          tableIdOrName: path.tableIdOrName
          inputs: requestBody.inputs
      - text: Apply partial edits {inputs} to multiple rows in HubDB table {tableIdOrName}.
        slots:
          inputs: requestBody.inputs
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/{rowId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one row from a published HubDB table
      effect: read
      questions:
      - How do I fetch a single live HubDB row by its ID?
      - Can a public HubDB table row be read without an access token?
      instructions:
      - text: Get published row {rowId} from HubDB table {tableIdOrName}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      - text: Show me what's live for row {rowId} in table {tableIdOrName}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/{rowId}/draft'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one row from a HubDB table's draft
      effect: read
      questions:
      - Where can I see the unpublished edits on one specific HubDB row?
      - Can I check a single row's draft values before I publish the table?
      instructions:
      - text: Get the draft version of row {rowId} in HubDB table {tableIdOrName}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      - text: Show the pending, unpublished values of row {rowId} in table {tableIdOrName}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/{rowId}/draft'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace every value in one HubDB row
      effect: write
      questions:
      - What happens to columns I leave out when I replace a HubDB row?
      - How do I overwrite one row completely rather than patching it?
      instructions:
      - text: Replace row {rowId} in table {tableIdOrName} entirely with the values {values}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
          values: requestBody.values
      - text: Overwrite all columns of draft row {rowId} in HubDB table {tableIdOrName}, clearing any I don't set.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/{rowId}/draft'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete one HubDB row
      effect: destructive
      questions:
      - How do I remove a single row from a HubDB table?
      - Is deleting one HubDB row permanent?
      instructions:
      - text: Permanently delete row {rowId} from HubDB table {tableIdOrName}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      - text: Remove just row {rowId} from the draft of table {tableIdOrName}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/{rowId}/draft'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit some columns of one HubDB row
      effect: write
      questions:
      - Can I change just one column on a HubDB row without touching the others?
      - How do I update the slug of a single dynamic page row in HubDB?
      instructions:
      - text: Update row {rowId} in table {tableIdOrName}, changing only {values}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
          values: requestBody.values
      - text: Set the page slug of row {rowId} in HubDB table {tableIdOrName} to {path}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
          path: requestBody.path
      method: generated
      generated: '2026-09-24'
- target: $.paths['/cms/v3/hubdb/2026-09/tables/{tableIdOrName}/rows/{rowId}/draft/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Duplicate one HubDB row
      effect: write
      questions:
      - How do I make a copy of a single HubDB row?
      - Can I give the duplicated row a new name when I clone it?
      instructions:
      - text: Clone row {rowId} in HubDB table {tableIdOrName}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
      - text: Copy row {rowId} of table {tableIdOrName} and call the copy {name}.
        slots:
          rowId: path.rowId
          tableIdOrName: path.tableIdOrName
          name: query.name
      method: generated
      generated: '2026-09-24'