v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB

Contacts Tables

Update Contacts Table

Rename a table, change its visibility, or reassign its owner. All fields except owner are optional — send only what changes.

Billing: Free.

patch/v3/contacts/tables/{table_id}

Path parameters

table_idstring required

The table's ID.

Request body

namestring

visibility'private' | 'shared'

archivedboolean

Set true to archive the table (hides it from default List Tables results), false to restore it.

Example request

{
  "name": "renamed",
  "visibility": "shared",
  "archived": true,
  "owner": {
    "email": "user@example.com"
  }
}

Response

Table updated

Example response

{
  "data": {
    "tableId": "482910",
    "name": "VP Sales US Tech Q2",
    "entityType": "contacts",
    "visibility": "private",
    "status": "active",
    "owner": {
      "id": 12345,
      "email": "owner@lusha.com",
      "name": "Ada Lovelace"
    },
    "createdBy": {
      "surface": "api",
      "createdByUserId": 12345
    },
    "workspaceUrl": "https://workspace.lusha.com/tables/482910",
    "entityCount": 5,
    "columns": [
      {
        "columnId": "c1",
        "name": "Job title",
        "type": "lusha",
        "key": "jobTitle"
      }
    ]
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}