Create table

POST

tables

const table = await client.tables.create({
  schema_id: "schema_abc123",
  name: "Q1 Product Catalog",
  file_ids: ["file_xyz789"],
  webhook_url: "https://your-server.com/webhooks",
});

console.log(table.id);     // "tbl_..."
console.log(table.status); // "processing"

table = client.tables.create(
    schema_id="schema_abc123",
    name="Q1 Product Catalog",
    file_ids=["file_xyz789"],
    webhook_url="https://your-server.com/webhooks",
)

print(table["id"])      # "tbl_..."
print(table["status"])  # "processing"

curl -X POST "https://hub.banditshq.com/api/v1/tables" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "schema_abc123",
    "name": "Q1 Product Catalog",
    "file_ids": ["file_xyz789"],
    "webhook_url": "https://your-server.com/webhooks"
  }'

{
  "id": "tbl_abc123",
  "name": "Q1 Product Catalog",
  "schema_id": "schema_xyz789",
  "status": "processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "files",
  "additional_context": null,
  "enhancement_context": null,
  "error_message": null,
  "files": [
    { "name": "catalog.pdf", "path": "company_123/file_xyz/catalog.pdf", "size": 1048576 }
  ],
  "created_at": "2025-03-10T14:30:00.000Z",
  "updated_at": "2025-03-10T14:30:00.000Z"
}

Request body

string

required

The ID of the schema to use for extraction.

string

required

A name for the table.

string[]

Array of file IDs (from the Files API) to extract data from. Provide exactly one of file_ids, file_urls, or source_text.

string[]

Array of publicly accessible URLs to extract data from.

string

Raw text content to extract data from.

string

Extra context to guide the extraction process.

string

Context for AI enhancement of extracted data.

string

URL to receive webhook notifications when processing completes.

Response

Returns the created table object with status processing.

string

Unique table identifier.

string

Table name.

string

Schema used for extraction.

string

Always processing for a new table.

integer

Extraction progress (0-100).

integer

Number of rows extracted so far (0 initially).

string

files or text.

string | null

Extraction context.

string | null

Enhancement context.

string | null

Error message if processing failed.

array

Uploaded file metadata.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

const table = await client.tables.create({
  schema_id: "schema_abc123",
  name: "Q1 Product Catalog",
  file_ids: ["file_xyz789"],
  webhook_url: "https://your-server.com/webhooks",
});

console.log(table.id);     // "tbl_..."
console.log(table.status); // "processing"

table = client.tables.create(
    schema_id="schema_abc123",
    name="Q1 Product Catalog",
    file_ids=["file_xyz789"],
    webhook_url="https://your-server.com/webhooks",
)

print(table["id"])      # "tbl_..."
print(table["status"])  # "processing"

curl -X POST "https://hub.banditshq.com/api/v1/tables" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "schema_abc123",
    "name": "Q1 Product Catalog",
    "file_ids": ["file_xyz789"],
    "webhook_url": "https://your-server.com/webhooks"
  }'

{
  "id": "tbl_abc123",
  "name": "Q1 Product Catalog",
  "schema_id": "schema_xyz789",
  "status": "processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "files",
  "additional_context": null,
  "enhancement_context": null,
  "error_message": null,
  "files": [
    { "name": "catalog.pdf", "path": "company_123/file_xyz/catalog.pdf", "size": 1048576 }
  ],
  "created_at": "2025-03-10T14:30:00.000Z",
  "updated_at": "2025-03-10T14:30:00.000Z"
}

Waiting for completion

Tables are processed asynchronously. Use the SDK’s built-in polling helper or configure a webhook.

const completed = await client.tables.waitForCompletion(table.id, {
  intervalMs: 3000,
  timeoutMs: 300000,
});

console.log(completed.status);     // "completed"
console.log(completed.total_rows); // 42

completed = client.tables.wait_for_completion(
    table["id"],
    interval_s=3,
    timeout_s=300,
)

print(completed["status"])      # "completed"
print(completed["total_rows"])  # 42

const table = await client.tables.create({
  schema_id: "schema_abc123",
  name: "Q1 Product Catalog",
  file_ids: ["file_xyz789"],
  webhook_url: "https://your-server.com/webhooks",
});

console.log(table.id);     // "tbl_..."
console.log(table.status); // "processing"

table = client.tables.create(
    schema_id="schema_abc123",
    name="Q1 Product Catalog",
    file_ids=["file_xyz789"],
    webhook_url="https://your-server.com/webhooks",
)

print(table["id"])      # "tbl_..."
print(table["status"])  # "processing"

curl -X POST "https://hub.banditshq.com/api/v1/tables" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "schema_abc123",
    "name": "Q1 Product Catalog",
    "file_ids": ["file_xyz789"],
    "webhook_url": "https://your-server.com/webhooks"
  }'

{
  "id": "tbl_abc123",
  "name": "Q1 Product Catalog",
  "schema_id": "schema_xyz789",
  "status": "processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "files",
  "additional_context": null,
  "enhancement_context": null,
  "error_message": null,
  "files": [
    { "name": "catalog.pdf", "path": "company_123/file_xyz/catalog.pdf", "size": 1048576 }
  ],
  "created_at": "2025-03-10T14:30:00.000Z",
  "updated_at": "2025-03-10T14:30:00.000Z"
}

Overview

Search

Enrich

Tables

Rows

Enhance

Schemas

Attributes

Files

Glossary

Credits

Catalog

Catalog Webhooks

Create table

Request body

Response

Waiting for completion

​Request body

​Response

​Waiting for completion

Request body

Response

Waiting for completion