ORorigami
Tables

List tables in the agent's workspace

Changed on

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 reach - its chat-linked tables plus its legacy workspace's tables when it has one; a caller cannot probe arbitrary containers through this path. Returned in the canonical list envelope with nextCursor always null; an agent's scope is rarely more than a handful of tables, so the endpoint does not paginate.

get/agents/{id}/tables

Request

  • Base URL
    https://origami.chat/api/v2
  • URL
    https://origami.chat/api/v2/agents/{id}/tables
  • Auth
    HTTP bearer

Query parameters

includestring
Example:stats

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

Response

Tables the agent can address (list envelope + the deprecated workspaceId container id).

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

  • 8c6b16fe0a3bRevision changes
    • breaking

      the response property /// became nullable for the status

    • info

      response property allOf[subschema #2]/items/items/workspaceId deprecated