Skip to content

Commit a0ba06e

Browse files
committed
docs(convex): note streaming export plan requirement on data-export tools (verified via live E2E)
1 parent ad189ac commit a0ba06e

5 files changed

Lines changed: 12 additions & 9 deletions

File tree

apps/docs/content/docs/en/integrations/convex.mdx

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ Sim's Convex integration connects your workflows to any Convex deployment with t
2828
- **Inspect your data model:** List Tables returns every table in the deployment with the JSON schema of its documents.
2929
- **Export and sync data:** List Documents pages through a consistent snapshot of a table, and Document Deltas returns only the documents that changed since a snapshot — including deletions — making incremental syncs to warehouses, search indexes, or other tools straightforward.
3030

31+
The Run Query, Run Mutation, Run Action, and Run Function operations work on every Convex plan. List Tables, List Documents, and Document Deltas use Convex's streaming export API, which is available on Convex paid plans.
32+
3133
Typical patterns include agents that read and write application data through your existing Convex functions, scheduled exports to analytics destinations, and change-driven automations that react to new or updated documents.
3234
{/* MANUAL-CONTENT-END */}
3335

@@ -122,7 +124,7 @@ Run any Convex function (query, mutation, or action) by path without specifying
122124

123125
### `convex_list_tables`
124126

125-
List all tables in a Convex deployment along with their JSON schemas
127+
List all tables in a Convex deployment along with their JSON schemas. Requires streaming export, available on Convex paid plans.
126128

127129
#### Input
128130

@@ -140,7 +142,7 @@ List all tables in a Convex deployment along with their JSON schemas
140142

141143
### `convex_list_documents`
142144

143-
List documents from a Convex table via a paginated snapshot. Pass the returned snapshot and page cursor back in to fetch the next page.
145+
List documents from a Convex table via a paginated snapshot. Pass the returned snapshot and page cursor back in to fetch the next page. Requires streaming export, available on Convex paid plans.
144146

145147
#### Input
146148

@@ -163,7 +165,7 @@ List documents from a Convex table via a paginated snapshot. Pass the returned s
163165

164166
### `convex_document_deltas`
165167

166-
List documents that changed after a snapshot or previous delta cursor. Deleted documents are returned with a _deleted flag.
168+
List documents that changed after a snapshot or previous delta cursor. Deleted documents are returned with a _deleted flag. Requires streaming export, available on Convex paid plans.
167169

168170
#### Input
169171

apps/sim/lib/integrations/integrations.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3224,15 +3224,15 @@
32243224
},
32253225
{
32263226
"name": "List Tables",
3227-
"description": "List all tables in a Convex deployment along with their JSON schemas"
3227+
"description": "List all tables in a Convex deployment along with their JSON schemas. Requires streaming export, available on Convex paid plans."
32283228
},
32293229
{
32303230
"name": "List Documents",
3231-
"description": "List documents from a Convex table via a paginated snapshot. Pass the returned snapshot and page cursor back in to fetch the next page."
3231+
"description": "List documents from a Convex table via a paginated snapshot. Pass the returned snapshot and page cursor back in to fetch the next page. Requires streaming export, available on Convex paid plans."
32323232
},
32333233
{
32343234
"name": "Document Deltas",
3235-
"description": "List documents that changed after a snapshot or previous delta cursor. Deleted documents are returned with a _deleted flag."
3235+
"description": "List documents that changed after a snapshot or previous delta cursor. Deleted documents are returned with a _deleted flag. Requires streaming export, available on Convex paid plans."
32363236
}
32373237
],
32383238
"operationCount": 7,

apps/sim/tools/convex/document_deltas.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ export const documentDeltasTool: ToolConfig<
1313
id: 'convex_document_deltas',
1414
name: 'Convex Document Deltas',
1515
description:
16-
'List documents that changed after a snapshot or previous delta cursor. Deleted documents are returned with a _deleted flag.',
16+
'List documents that changed after a snapshot or previous delta cursor. Deleted documents are returned with a _deleted flag. Requires streaming export, available on Convex paid plans.',
1717
version: '1.0.0',
1818

1919
params: {

apps/sim/tools/convex/list_documents.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ export const listDocumentsTool: ToolConfig<ConvexListDocumentsParams, ConvexList
1111
id: 'convex_list_documents',
1212
name: 'Convex List Documents',
1313
description:
14-
'List documents from a Convex table via a paginated snapshot. Pass the returned snapshot and page cursor back in to fetch the next page.',
14+
'List documents from a Convex table via a paginated snapshot. Pass the returned snapshot and page cursor back in to fetch the next page. Requires streaming export, available on Convex paid plans.',
1515
version: '1.0.0',
1616

1717
params: {

apps/sim/tools/convex/list_tables.ts

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@ import type { ToolConfig } from '@/tools/types'
55
export const listTablesTool: ToolConfig<ConvexListTablesParams, ConvexListTablesResponse> = {
66
id: 'convex_list_tables',
77
name: 'Convex List Tables',
8-
description: 'List all tables in a Convex deployment along with their JSON schemas',
8+
description:
9+
'List all tables in a Convex deployment along with their JSON schemas. Requires streaming export, available on Convex paid plans.',
910
version: '1.0.0',
1011

1112
params: {

0 commit comments

Comments
 (0)