Skip to main content
GET
/
api
/
v2
/
public
/
tables
curl -X GET "https://app.refold.ai/api/v2/public/tables?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

{
  "docs": [
    {
      "_id": "6a26a509ca55ea91ae063313",
      "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
      "linked_account_id": "user_12345",
      "name": "leads",
      "environment": "test",
      "table_type": "persistent",
      "is_deleted": false
    }
  ],
  "totalDocs": 12,
  "limit": 10,
  "page": 1,
  "totalPages": 2,
  "hasNextPage": true
}
List the persistent tables in your organization and environment, paginated. Persistent tables are API-managed data tables (unlike datastores, which are written by workflow executions). Each table carries the linked_account_id it belongs to.

​
Authentication

​
x-api-key
string
required
Your Refold API key.
​
linked_account_id
string
Optional — filter to a single linked account’s tables.

​
Query Parameters

​
page
integer
default:"1"
Page number.
​
limit
integer
default:"10"
Page size.

​
Response

Returns a paginated envelope.
​
docs
array
Table objects.
​
totalDocs
integer
Total tables.
​
hasNextPage
boolean
Whether another page follows.
{
  "docs": [
    {
      "_id": "6a26a509ca55ea91ae063313",
      "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
      "linked_account_id": "user_12345",
      "name": "leads",
      "environment": "test",
      "table_type": "persistent",
      "is_deleted": false
    }
  ],
  "totalDocs": 12,
  "limit": 10,
  "page": 1,
  "totalPages": 2,
  "hasNextPage": true
}

curl -X GET "https://app.refold.ai/api/v2/public/tables?limit=10" \
  -H "x-api-key: YOUR_API_KEY"