Swap tables

Toolset feed_lookups, 6 tools.

RecordsCopy Anchor Link

feed_lookupCopy Anchor Link

A table that swaps a store value for the value a site wants (e.g. category names, colour names), used by feed rules. List shows each table with its source, row count, last refresh, last error and the rules that read it; get adds its rows and updated_at for a change.

• Permission: feeds.read
• Tools: feed_lookup_list, feed_lookup_get

ActionsCopy Anchor Link

feed_lookup_createCopy Anchor Link

Create a swap table from rows the merchant gave or a shared Google Sheet link.

Checked as the table editor checks it (up to 20000 rows). Needs swap tables in the plan.

• Action key: feed_lookup.create
• Permission: feeds.write
• Approval: Always waits for a person to approve it.
• Effect: Changes the live store.
• Retries: runs at most once; a repeat with the same idempotency key returns the first result.

Example inputs:

{
  "name": "Colours",
  "content": {
    "source": "inline",
    "rows": [
      {
        "key": "Piros",
        "value": "Red"
      }
    ]
  }
}

{
  "name": "Sizes",
  "content": {
    "source": "sheet",
    "url": "https://docs.google.com/spreadsheets/d/abc/edit"
  }
}

feed_lookup_deleteCopy Anchor Link

Delete a swap table; refused while a rule still reads it.

• Action key: feed_lookup.delete
• Permission: feeds.write
• Approval: Always waits for a person to approve it.
• Effect: Changes the live store.
• Destructive: in compact mode it runs with run_destructive_action.
• Retries: safe to repeat with the same input.

Example input:

{
  "lookup_id": "019bb2a5-91bc-7241-8a8d-06e8c0daaa94"
}

feed_lookup_refreshCopy Anchor Link

Read a sheet-backed swap table from its Google Sheet again.

• Action key: feed_lookup.refresh
• Permission: feeds.write
• Approval: Runs without approval.
• Effect: Changes the live store.
• Retries: safe to repeat with the same input.

Example input:

{
  "lookup_id": "019bb2a5-91bc-7241-8a8d-06e8c0daaa94"
}

feed_lookup_updateCopy Anchor Link

Rename a swap table, replace its rows, or both.

Send the updated_at read with feed_lookup_get as expected_updated_at: a table changed meanwhile refuses the change. A rename is written into every rule that reads the table. Needs swap tables in the plan.

• Action key: feed_lookup.update
• Permission: feeds.write
• Approval: Always waits for a person to approve it.
• Effect: Changes the live store.
• Retries: safe to repeat with the same input.

Example input:

{
  "lookup_id": "019bb2a5-91bc-7241-8a8d-06e8c0daaa94",
  "expected_updated_at": "2026-10-01T10:00:00Z",
  "name": "Colour names"
}