Update column

Path parameters

• table_idrequired

  string

  Target table ID.

• column_idrequired

  string

  Target column ID.

Body parameters

• label · optional

  string

  Updated display label.

• kind · optional

  string

  Column kind: manual, source, formatter, enrichment, json-explode, projection, external_id, or system.

• dataType · optional

  string

  Data type: text, number, date, boolean, email, url, json, or message.

• textFormat · optional

  string

  Text rendering format: plain, markdown, long_text, or code.

• origin · optional

  string

  Column origin: manual, csv, api, ai, email_finder, email_validator, phone_finder, outreach, onboarding, crm_export, list_builder, agent_run, agent_source, or system.

• source · optional

  object

  Optional source metadata object.

• sourceId · optional

  string

  Optional source identifier.

• importVersion · optional

  number

  Optional import version metadata.

• fieldSemantics · optional

  object

  Optional field semantics metadata.

• valueSchema · optional

  object

  Optional value schema metadata.

• version · optional

  number

  Optional column version metadata.

• status · optional

  string

  Column status: idle, running, or error.

• costEstimate · optional

  number

  Optional cost estimate metadata.

• lastRunAt · optional

  string

  Optional last-run timestamp metadata.

• errorMessage · optional

  string

  Optional last error message metadata.

• isHidden · optional

  boolean

  Whether the column is hidden.

• position · optional

  number

  Updated explicit float sort order for the column.

• isImportant · optional

  boolean

  Marks or unmarks the column as a favorite/starred context field for draft and calling fallback.

• config · optional

  object

  Updated column config.

• config.provider · optional

  string

  Provider key (for example add_to_crm, sync_to_table, add_to_sequence).

• suppressSaveAutoRun · optional

  boolean

  Save-hook control (default true on update). When false, permits save-time auto-run scheduling; ordinary clients should omit it.

• config.selectedRowFields · optional

  array<string>

  For LLM enrichment: exact source column keys (or key.path tokens) to include in each row input. Use keys available in the table schema.

• config.selectedRowFieldRefs · optional

  array<object>

  Optional stable bindings for selectedRowFields. Each object uses snake_case column_id, column_key, and path; path may be empty for the whole value.

• config.selectedRowFieldRefs[].column_id · optional

  string

  Stable source-column ID. References missing a complete binding are ignored.

• config.selectedRowFieldRefs[].column_key · optional

  string

  Current source column key; together with path it must form a selectedRowFields token.

• config.selectedRowFieldRefs[].path · optional

  string

  Optional nested JSON path; omitted or empty selects the whole column value.

• config.destinationTableId · optional

  string

  sync_to_table single destination id.

• config.columnMappings · optional

  array<object>

  sync_to_table mapping entries (sourceKey/destKey) or route-level mappings.

• config.routes · optional

  array<object>

  sync_to_table router routes (first matching route wins); routes can define condition, syncMode, syncBehavior, listSourceColumnId, listPath, and columnMappings.

• config.syncMode · optional

  string

  sync_to_table mode: row or list.

• config.syncBehavior · optional

  string

  sync_to_table behavior: link or copy.

• config.listSourceColumnId · optional

  string

  sync_to_table list mode source JSON column ID whose items[] payload should be expanded.

• config.listPath · optional

  string

  sync_to_table list mode optional item array path (default items).

• config.columnMappings[].sourceScope · optional

  string

  sync_to_table list mode mapping scope: row or item.

• config.columnMappings[].itemKey · optional

  string

  sync_to_table list mode item field name when sourceScope=item.

• config.columnMappings[].sourceKey · optional

  string

  sync_to_table row mapping source column key when sourceScope=row.

• config.columnMappings[].path · optional

  string

  sync_to_table row mapping nested JSON path inside sourceKey.

• config.fieldMappings · optional

  object

  add_to_crm mapping contract from source columns into canonical lead fields.

• config.fieldMappings.companyDomain · optional

  string

  add_to_crm source domain column key.

• config.fieldMappings.linkedinUrl · optional

  string

  add_to_crm source LinkedIn column key.

• config.fieldMappings.emailAddresses · optional

  array<object>

  add_to_crm email mappings; structured sources require explicit path.

• config.fieldMappings.emailAddresses[].column · optional

  string

  add_to_crm email source column key.

• config.fieldMappings.emailAddresses[].path · optional

  string

  add_to_crm email JSON path/key (for example response).

• config.fieldMappings.phoneNumbers · optional

  array<object>

  add_to_crm phone mappings; structured sources require explicit path.

• config.fieldMappings.phoneNumbers[].column · optional

  string

  add_to_crm phone source column key.

• config.fieldMappings.phoneNumbers[].path · optional

  string

  add_to_crm phone JSON path/key (for example mobile_number).

• config.fieldMappings.common · optional

  object

  Add to Leads multi-source parent-row mappings applied to every lead source.

• config.fieldMappings.leadSources · optional

  array<object>

  Add to Leads multi-source row/array sources.

• config.fieldMappings.leadSources[].kind · optional

  string

  Add to Leads source kind: row or array.

• config.fieldMappings.leadSources[].sourceColumn · optional

  string

  Add to Leads array source JSON column key.

• config.fieldMappings.leadSources[].sourceArrayPath · optional

  string

  Add to Leads array path inside sourceColumn, commonly items.

• config.fieldMappings.leadSources[].template · optional

  object

  Add to Leads canonical lead field mappings from row columns or __array_item paths.

• config.sourceColumns · optional

  array<string>

  add_to_crm dependency/source column list.

• config.sequenceId · optional

  string

  add_to_sequence: target sequence id. Must be ACTIVE and linked to this table via sourceTableId.

• config.sourceLeadColumn · optional

  string

  add_to_sequence: column key (not field name) of the add_to_crm or lead_finder column containing lead IDs.

• config.assignedToUserId · optional

  string

  add_to_sequence: assignee for generated sequence tasks. Omit sender routing to use the assignee defaults.

• config.skipActiveSequenceConflicts · optional

  boolean

  add_to_sequence: skip people already active in another sequence. Recommended for automated/table-driven handoffs.

• config.senderAccountIds · optional

  object

  add_to_sequence advanced routing: explicit sender account IDs keyed by email/linkedin.

• config.assignmentPlan · optional

  array<object>

  add_to_sequence advanced/team routing: routes with assigneeUserId, optional senderAccountIds, and optional weight.

• config.routingMode · optional

  string

  add_to_sequence advanced/team routing: single, round_robin, or weighted_round_robin.

• config.url · optional

  string

  http_request URL template. Use {{column_key}} for row values and {{secrets.name}} for workspace secrets.

• config.method · optional

  string

  http_request HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS).

• config.headers · optional

  object

  http_request key-value header pairs. Values support {{secrets.name}} templates.

• config.body · optional

  string | object

  http_request body template. Can be null, a string, or a JSON object.

• config.timeoutSeconds · optional

  number

  http_request timeout in seconds (default 30).

• autoRun · optional

  string

  Auto-run trigger: never, onInsert, or onSourceUpdate.

• config.runCondition · optional

  RunCondition

  Optional recursive column-owned predicate. Applied to candidate rows for auto-run, /run, and /estimate; omit to consider all candidate rows.

Definitions

{
  "mode": "and",
  "filters": [
    { "columnKey": "linkedin_url", "operator": "isNotEmpty" },
    { "columnKey": "country", "operator": "equals", "value": "United States" }
  ]
}

{
  "type": "all",
  "children": [
    {
      "type": "condition",
      "columnKey": "linkedin_url",
      "operator": "isNotEmpty",
      "missingPolicy": "unknown"
    },
    {
      "type": "condition",
      "columnKey": "country",
      "operator": "equals",
      "missingPolicy": "unknown",
      "value": "United States"
    }
  ]
}

Errors