Integrations overview - ReyGrid Docs

Official SDKs wrap the REST API with typed clients. Both cover the same endpoints and default to https://reygrid.com/api/v1. For no-code automation there is also an N8N node (npm package n8n-nodes-reygrid).

Python SDK

pip install reygrid. Sync and async methods built on httpx. Python 3.9+.

TypeScript SDK

npm install reygrid. Fetch-based, no runtime HTTP dependency. Node.js 18+, ESM.

N8N Node

Chat with agents from n8n workflows, with automatic AI tool calls.

Feature comparison

Capability	Python	TypeScript
Package	`reygrid` (PyPI)	`reygrid` (npm)
Client class	`ReyGrid`	`ReyGrid`
Version documented	1.0.3	1.0.3
Sync + async	Both (`async_` prefix)	Promises / async generators
Streaming	`stream_chat` / `async_stream_chat`	`streamChat`
Pagination helper	`Paginator`	`Paginator<T>`
Naming	`snake_case` methods and arguments	`camelCase`
Base URL option	`base_url`	`baseUrl`
Timeout option	`timeout` (seconds)	`timeoutMs` (milliseconds)

Method map

Endpoint	Python	TypeScript
`GET /ping`	`ping()`	`ping()`
`GET /validate`	`validate()`, `get_usage()`	`validate()`, `getUsage()`
`POST /agents/{id}/chat`	`chat()`	`chat()`
`POST /agents/{id}/chat` (SSE)	`stream_chat()`	`streamChat()`
`GET /agents/{id}/conversations`	`list_conversations()`	`listConversations()`
`GET …/{ref}/messages`	`list_messages()`	`listMessages()`
`DELETE …/{ref}`	`delete_conversation()`	`deleteConversation()`
`DELETE …/messages/{id}`	`delete_message()`	`deleteMessage()`
`POST …/tool/cancel/{id}`	`cancel_tool_call()`	`cancelToolCall()`
`POST …/messages/{id}/feedback`	`rate_message()`	`rateMessage()`
`GET /agents`	`list_agents()`	`listAgents()`
`GET /agents/{id}`	`get_agent()`	`getAgent()`
`PATCH /agents/{id}`	`update_agent()`	`updateAgent()`
`GET /agents/{id}/sources`	`list_sources()`, `paginate_sources()`	`listSources()`, `paginateSources()`
`POST …/sources/text`	`add_text_source()`	`addTextSource()`
`POST …/sources/qa`	`add_qa_source()`	`addQaSource()`
`POST …/sources/files`	`upload_file()`	`uploadFile()`
`POST …/sources/website`	`crawl_website()`	`crawlWebsite()`
`DELETE …/sources/{sourceId}`	`delete_source()`	`deleteSource()`
`POST /agents/{id}/search`	`search()`	`search()`
`GET /models`	`list_models()`	`listModels()`
`GET /usage`	`get_usage_report()`	`getUsageReport()`

Python async variants are prefixed async_ (for example async_chat()).

Where the SDKs and the REST API differ, these pages describe the SDK’s actual behavior.

Python SDK

TypeScript SDK

N8N Node

​Feature comparison

​Method map

Feature comparison

Method map