List tables in the agent's workspace

curl --request GET \
  --url https://origami.chat/api/v2/agents/{id}/tables \
  --header 'Authorization: Bearer <token>'

{
  "object": "<string>",
  "items": [
    {
      "object": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "leadCount": 123,
      "columns": [
        {
          "object": "<string>",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "type": "<string>",
          "slug": "<string>",
          "autoTrigger": true,
          "credits": {
            "lifetimeUsed": 123
          },
          "cells": {
            "running": 1,
            "errored": 1
          },
          "stats": {
            "avgCreditsPerRun": 123,
            "callRate": 0.5,
            "totalRuns": 123
          },
          "qualification": {
            "pass": 123,
            "fail": 123,
            "unsure": 123,
            "total": 123
          }
        }
      ],
      "credits": {
        "lifetimeUsed": 123
      },
      "cells": {
        "running": 1,
        "errored": 1
      },
      "url": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "stats": {
        "creditsPerLead": 123,
        "creditsPerQualifiedLead": 123,
        "findMoreEstimatedCredits": 123,
        "qualification": {
          "rate": 0.5,
          "fetchRate": 0.5,
          "qualifiedLeads": 123,
          "effectiveLeadsPerQualified": 123,
          "estimatedQualifiedLeads": 123
        },
        "funnel": {
          "totalSourcedLeads": 123,
          "postStaticLeads": 123,
          "dedupedLeads": 123,
          "dedupRate": 0.5,
          "excludedLeads": 123,
          "excludedRate": 0.5
        },
        "running": {
          "runningLeads": 123,
          "oldestActiveRunStartedAt": "2023-11-07T05:31:56Z"
        },
        "leadSources": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "avgCreditsPerLead": 123,
            "totalCredits": 123,
            "totalLeads": 123
          }
        ],
        "hasUnknownTotalWithMore": true
      }
    }
  ],
  "nextCursor": "<string>",
  "url": "<string>",
  "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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

List tables in the agent's workspace

curl --request GET \
  --url https://origami.chat/api/v2/agents/{id}/tables \
  --header 'Authorization: Bearer <token>'

{
  "object": "<string>",
  "items": [
    {
      "object": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "leadCount": 123,
      "columns": [
        {
          "object": "<string>",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "type": "<string>",
          "slug": "<string>",
          "autoTrigger": true,
          "credits": {
            "lifetimeUsed": 123
          },
          "cells": {
            "running": 1,
            "errored": 1
          },
          "stats": {
            "avgCreditsPerRun": 123,
            "callRate": 0.5,
            "totalRuns": 123
          },
          "qualification": {
            "pass": 123,
            "fail": 123,
            "unsure": 123,
            "total": 123
          }
        }
      ],
      "credits": {
        "lifetimeUsed": 123
      },
      "cells": {
        "running": 1,
        "errored": 1
      },
      "url": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "stats": {
        "creditsPerLead": 123,
        "creditsPerQualifiedLead": 123,
        "findMoreEstimatedCredits": 123,
        "qualification": {
          "rate": 0.5,
          "fetchRate": 0.5,
          "qualifiedLeads": 123,
          "effectiveLeadsPerQualified": 123,
          "estimatedQualifiedLeads": 123
        },
        "funnel": {
          "totalSourcedLeads": 123,
          "postStaticLeads": 123,
          "dedupedLeads": 123,
          "dedupRate": 0.5,
          "excludedLeads": 123,
          "excludedRate": 0.5
        },
        "running": {
          "runningLeads": 123,
          "oldestActiveRunStartedAt": "2023-11-07T05:31:56Z"
        },
        "leadSources": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "avgCreditsPerLead": 123,
            "totalCredits": 123,
            "totalLeads": 123
          }
        ],
        "hasUnknownTotalWithMore": true
      }
    }
  ],
  "nextCursor": "<string>",
  "url": "<string>",
  "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string<uuid>

required

Query Parameters

include

string

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

Example:

"stats"

Response

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

The canonical v2 list envelope. Every list endpoint returns this shape; per-endpoint items element types (and documented extras like total) are declared on each operation.

object

string

required

Allowed value: "list"

items

object[]

required

The page of objects. Element type is per-endpoint.

Show child attributes

nextCursor

string | null

required

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

url

string

required

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

workspaceId

string<uuid>

required

Get table List columns