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

Changes

No recorded changes to this endpoint across all 1 revision of this API.