list_datasets

Tools that can return a lot of rows — ask_onfire, ai_prospecting, the signals tools, crm_write_results and others — write the full result to a short-lived dataset (CSV in S3) and return a compact envelope with a handle. list_datasets enumerates the ones still alive for your tenant.

Inputs

Parameter	Type	Required	Description
target_tenant_id	string	No	Super tenants only — list another tenant’s datasets.

Returns

One entry per dataset:

• id — the ds_... handle to pass to describe_dataset, query_datasets, download_dataset, or contact_data_enrichment.
• row_count and columns.
• source — which tool produced it.
• expires_at.

Notes & limits

• Datasets are short-lived: the bucket enforces a 7-day lifecycle.
• A dataset holds up to 100,000 rows.