v1

latestOpenAPI 3.1.02026-07-267154122.0 KB
Tables

List tables in the agent's workspace

The fallback discovery surface in v2. The run object only carries response.tables[] for tables a specific run touched (empty when the run made no mutations or stopped on a question), so callers that need "every table this agent has access to" use this endpoint instead.

Each entry is a full TableObject — same shape as GET /api/v2/tables/{id} and the same shape embedded under Run.response.tables[]. Pass ?include=stats to attach the economics block (per-table + per-column).

Scoped to the agent's own workspace; a caller cannot probe arbitrary workspaces through this path. Returned in the canonical list envelope with nextCursor always null — an agent's workspace is rarely more than a handful of tables, so the endpoint does not paginate.

get/agents/{id}/tables

Query parameters

includestring
Example:stats

Pass stats to attach per-table economics on every entry (creditsPerLead, qualification, funnel, lead sources).

Response

Tables in the agent's workspace (list envelope + workspaceId).

object'list' required
nextCursorstring nullable required

Cursor for the next page; null means this is the last page.

urlstring required

The path this list was fetched from (query string excluded).

workspaceIdstring uuid required