New: use Extruct search and tables from Claude, Codex, and more with the remote MCP server.
API Reference
Company Search
Deep Search
Table Management
Table Execution
New: use Extruct search and tables from Claude, Codex, and more with the remote MCP server.
Table Management
Update Table
Update table metadata.
PATCH
/
v1
/
tables
/
{table_id}
Update Table
curl --request PATCH \
--url https://api.extruct.ai/v1/tables/{table_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"columns_order": [
"<string>"
]
}
'{
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"kind": "generic",
"columns": [
{
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"config": {
"name": "<string>",
"key": "<string>",
"kind": "input"
}
}
],
"owner": {
"id": "<string>",
"email": "<string>"
},
"description": "<string>",
"tags": [
"<string>"
],
"child_relationships": [
{
"table_id": "<string>",
"relationship_type": "company_people"
}
],
"parent_relationships": [
{
"table_id": "<string>",
"relationship_type": "company_people"
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.extruct.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
This endpoint updates table metadata such as name, description, tags, or column order.Example request
export EXTRUCT_API_TOKEN="YOUR_API_TOKEN"
export TABLE_ID="YOUR_TABLE_ID"
curl -X PATCH "https://api.extruct.ai/v1/tables/${TABLE_ID}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${EXTRUCT_API_TOKEN}" \
-d '{
"name": "Company Research v2",
"description": "Updated enrichment scope"
}'
Key parameters
table_id(required): target table identifier.- Body fields (all optional):
name,description,tags,columns_order.
Success signal
A successful response returns the updated table metadata with the sameid.
Common errors
401 Unauthorized
Check that your header is Authorization: Bearer ${EXTRUCT_API_TOKEN}.
404 Not Found
The table ID is invalid or unavailable in your workspace.
422 Unprocessable Entity
Most often caused by invalid JSON or unsupported field shapes.
Related endpoints
Related guides
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json
Response
Successful Response
Table ID.
Table creation time.
Table name.
Table type.
Available options:
generic, company, people Table columns configurations.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Table description.
Table tags.
Child table relationships.
Show child attributes
Show child attributes
Parent table relationships.
Show child attributes
Show child attributes
⌘I
Update Table
curl --request PATCH \
--url https://api.extruct.ai/v1/tables/{table_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"columns_order": [
"<string>"
]
}
'{
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"kind": "generic",
"columns": [
{
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"config": {
"name": "<string>",
"key": "<string>",
"kind": "input"
}
}
],
"owner": {
"id": "<string>",
"email": "<string>"
},
"description": "<string>",
"tags": [
"<string>"
],
"child_relationships": [
{
"table_id": "<string>",
"relationship_type": "company_people"
}
],
"parent_relationships": [
{
"table_id": "<string>",
"relationship_type": "company_people"
}
]
}