> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewship.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Table

> Update table name, description, or columns

## Path Parameters

<ParamField path="id" type="string" required>
  Table ID
</ParamField>

## Request

<ParamField body="name" type="string">
  New table name
</ParamField>

<ParamField body="description" type="string">
  New description (`null` clears the description)
</ParamField>

<ParamField body="columns" type="array">
  Full replacement of column definitions
</ParamField>

## Response

<ResponseField name="id" type="string">
  Table ID
</ResponseField>

<ResponseField name="name" type="string">
  Updated table name
</ResponseField>

<ResponseField name="description" type="string">
  Updated description
</ResponseField>

<ResponseField name="columns" type="array">
  Updated column definitions
</ResponseField>

<ResponseField name="row_count" type="number">
  Current row count
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.crewship.dev/v1/tables/tbl_abc123xyz789 \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "qualified_leads",
      "description": "Only qualified prospects"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "id": "tbl_abc123xyz789",
    "name": "qualified_leads",
    "description": "Only qualified prospects",
    "columns": [
      { "name": "company", "type": "text", "required": true },
      { "name": "score", "type": "number", "required": false }
    ],
    "row_count": 42,
    "created_at": "2024-01-15T10:35:00Z",
    "updated_at": "2024-01-20T08:12:00Z"
  }
  ```
</ResponseExample>