Skip to main content
List a table’s columns with each basic and action column’s full settings — formula, data type, and action config. Source columns carry no settings, only per-source record counts. For an abbreviated listing without settings, use clay tables columns list. 
clay tables columns get <tableId>

​
Arguments

ArgumentDescription
tableIdThe id of the table whose columns to fetch. Required.

​
Output

Each column is discriminated on type. The settings object appears on basic and action columns (absent when the column has none) and its shape is discriminated on type. The sources array appears on source columns. 
{
  "data": [
    {
      "type": "action",
      "id": "col_act",
      "name": "Find email",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "settings": {}
    },
    {
      "type": "source",
      "id": "col_src",
      "name": "Imported CSV",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "sources": [{ "id": "src_1", "name": "leads.csv", "numSourceRecords": 500 }]
    }
  ]
}
FieldTypeDescription
data[].type"basic" | "action" | "source"Column kind. Discriminates the shape.
data[].idstringColumn id.
data[].namestringDisplay name.
data[].updatedAtstringLast-updated timestamp.
data[].settingsobjectBasic and action columns only. Full column settings; absent when the column has none.
data[].sourcesarraySource columns only. One entry per attached source.
data[].sources[].numSourceRecordsnumberNumber of records imported from that source.
Column types: basic is a plain data column (optionally formula-backed), action runs an action or enrichment to populate the column, and source represents attached data source(s) and carries no settings.

​
Errors

CodeExitNotes
validation_error2The tableId argument is required, or the table is an archive table.
not_found6No table with that id in the workspace.
auth_forbidden3The API key lacks the cli:all scope, or you cannot read this table.

​
Examples

clay tables columns get tbl_123
clay tables columns get tbl_123 | jq '.data[] | select(.type == "action") | .settings'
clay tables columns get tbl_123 | jq -r '.data[] | select(.type == "source") | .sources[].numSourceRecords'