Create a table and start extraction

POST

tables

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/tables \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    "name": "August supplier feed",
    "source_text": "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
    "additional_context": "Prices use EUR."
  }'

const response = await fetch("https://app.productlasso.com/api/v1/tables", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    schema_id: "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    name: "August supplier feed",
    source_text: "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
    additional_context: "Prices use EUR.",
  }),
});

if (!response.ok) throw new Error(await response.text());
const table = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/tables",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
        "name": "August supplier feed",
        "source_text": "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
        "additional_context": "Prices use EUR.",
    },
    timeout=30,
)
response.raise_for_status()
table = response.json()

{
  "id": "d2b3dbe0-c77d-40d8-a5d2-480722489c64",
  "name": "August supplier feed",
  "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
  "status": "queued_for_processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "text",
  "additional_context": "Prices use EUR.",
  "enhancement_context": null,
  "error_message": null,
  "files": [],
  "locked": false,
  "locked_at": null,
  "locked_by": null,
  "skipped_source_updates": 0,
  "last_skipped_source_update_at": null,
  "created_at": "2026-08-31T09:15:00.000Z",
  "updated_at": "2026-08-31T09:15:00.000Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Usage notes

For a working extraction, provide exactly one source: a non-empty file_ids array or non-empty source_text.
file_urls remains accepted as a legacy compatibility field, but the extraction worker does not download those URLs. The request can be queued without producing a valid extraction. Download the remote file and upload it with POST /files first.
Duplicate source file names are rejected. The combined extraction size limit is 512 MB.
The selected Product Schema is copied into the table when you create it. Later changes to the reusable Product Schema do not rewrite the table’s snapshot.
A successful request returns 201 with status queued_for_processing. Poll GET /tables/{table_id} until the status is completed, error, or cancelled.
Set webhook_url to receive the final extraction result without polling.

The upload limit and the extraction limit are different. See Files and extraction limits before submitting large documents.

Examples

curl --request POST \
  --url https://app.productlasso.com/api/v1/tables \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    "name": "August supplier feed",
    "source_text": "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
    "additional_context": "Prices use EUR."
  }'

const response = await fetch("https://app.productlasso.com/api/v1/tables", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    schema_id: "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    name: "August supplier feed",
    source_text: "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
    additional_context: "Prices use EUR.",
  }),
});

if (!response.ok) throw new Error(await response.text());
const table = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/tables",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
        "name": "August supplier feed",
        "source_text": "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
        "additional_context": "Prices use EUR.",
    },
    timeout=30,
)
response.raise_for_status()
table = response.json()

Example response

{
  "id": "d2b3dbe0-c77d-40d8-a5d2-480722489c64",
  "name": "August supplier feed",
  "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
  "status": "queued_for_processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "text",
  "locked": false,
  "created_at": "2026-08-31T09:15:00.000Z",
  "updated_at": "2026-08-31T09:15:00.000Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

schema_id

string

required

Schema defining the column structure

name

string

required

Table name

file_ids

string<uuid>[]

IDs of previously uploaded files

Minimum array length: 1

file_urls

string<uri>[]

deprecated

Legacy compatibility field. The handler accepts and queues these URLs, but the current extraction worker does not download them, so the extraction cannot complete correctly. Download each file and use file_ids instead.

source_text

string

Raw text containing product data

Minimum string length: 1

additional_context

string

Extra instructions for the AI extraction

enhancement_context

string

Default context for all AI enhancements on this table

webhook_url

string<uri>

URL to notify when extraction completes or fails

Response

Created table, extraction started

string

required

name

string

required

schema_id

string

required

status

enum<string>

required

Raw extraction job status returned by the API.

Available options:

queued,

queued_for_processing,

processing,

processing_by_worker,

completed,

error,

cancelled

total_rows

integer

required

created_at

string<date-time>

required

updated_at

string<date-time>

required

progress

integer

Required range: 0 <= x <= 100

source_type

enum<string>

Available options:

files,

text

additional_context

string | null

enhancement_context

string | null

error_message

string | null

files

object[]

Show child attributes

locked

boolean

locked_at

string<date-time> | null

locked_by

string<uuid> | null

skipped_source_updates

integer

last_skipped_source_update_at

string<date-time> | null

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/tables \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    "name": "August supplier feed",
    "source_text": "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
    "additional_context": "Prices use EUR."
  }'

const response = await fetch("https://app.productlasso.com/api/v1/tables", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    schema_id: "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    name: "August supplier feed",
    source_text: "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
    additional_context: "Prices use EUR.",
  }),
});

if (!response.ok) throw new Error(await response.text());
const table = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/tables",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
        "name": "August supplier feed",
        "source_text": "SKU,Name,Price\nA-100,Alpine bottle,24.90\nA-101,Trail mug,18.50",
        "additional_context": "Prices use EUR.",
    },
    timeout=30,
)
response.raise_for_status()
table = response.json()

{
  "id": "d2b3dbe0-c77d-40d8-a5d2-480722489c64",
  "name": "August supplier feed",
  "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
  "status": "queued_for_processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "text",
  "additional_context": "Prices use EUR.",
  "enhancement_context": null,
  "error_message": null,
  "files": [],
  "locked": false,
  "locked_at": null,
  "locked_by": null,
  "skipped_source_updates": 0,
  "last_skipped_source_update_at": null,
  "created_at": "2026-08-31T09:15:00.000Z",
  "updated_at": "2026-08-31T09:15:00.000Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Overview

Search

Enrich

Tables

Rows

Enhance

Schemas

Attributes

Files

Glossary

Credits

Product analytics

Catalog

Catalog Webhooks

Create a table and start extraction

Usage notes

Examples

Authorizations

Body

Response

​Usage notes

​Examples

Authorizations

Body

Response

Usage notes

Examples