Skip to main content

​
What are toolkits?

Toolkits are bundles of related tools, usually from one provider or product. For example the Slack toolkit includes “send message”, “list channels”, “create channel”; the Gmail toolkit includes “send email”, “search emails”, “create draft”. Each toolkit has a slug (e.g. slack, gmail), a name, description, and a list of tools. You use toolkits to:
  • Browse by product — “Show me everything for Slack” instead of searching thousands of tools.
  • Configure auth once — You connect a toolkit (e.g. Slack) via an auth config and optionally a connected account; then all tools in that toolkit can use that connection.
  • Attach to workflows — When building a workflow, you often pick toolkits or specific tools; the toolkit is the logical grouping.
So: tools are the individual actions; toolkits are the boxes they come in (Slack box, Gmail box, etc.).

​
Example use cases

  • Tool picker in your app — List toolkits with GET /toolkits or GET /toolkits/with-tools (the latter includes the tools inside each toolkit). Let users search by keyword and select toolkits or tools.
  • Filter tools — When listing tools, use toolkitSlug=slack to get only Slack tools.
  • MCP / integrations — Some integrations need “which toolkits (and tools) are available”; the with-tools endpoint returns that in one call.

​
How it works

  • List toolkits — Returns slug, name, description, logo, tools count. Search with q (e.g. “slack”, “calendar”).
  • List toolkits with tools — Same but each toolkit includes a tools array. Search applies to both toolkit name and tool name/description. Use when you need the full list of tools per toolkit in one request.

​
API endpoints

​
List toolkits

GET https://flowra.dev/api/v1/toolkits returns a paginated list of toolkits. Each item includes slug, name, description, logo, tools count, auth info, and more.

​
Query parameters (list toolkits)

ParameterTypeDescription
qstringSearch keyword — Filters toolkits by name or slug. Use this to search between toolkits.
pagenumberPage number (1-based). Default: 1.
limitnumberItems per page (1–100). Default: 20.
offsetnumberNumber of items to skip (offset-based pagination).
sortBystringField to sort by (e.g. name, popularityScore).
sortOrderstringASC or DESC. Default: DESC.

​
Example: list toolkits

curl -X GET "https://flowra.dev/api/v1/toolkits?limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Example: search toolkits by keyword

Search for toolkits whose name or slug matches a keyword (e.g. “slack”, “gmail”, “calendar”): 
curl -X GET "https://flowra.dev/api/v1/toolkits?q=slack&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Example: sort by name

curl -X GET "https://flowra.dev/api/v1/toolkits?sortBy=name&sortOrder=ASC&limit=50" \
  -H "x-api-key: YOUR_API_KEY"

​
List toolkits with nested tools

GET https://flowra.dev/api/v1/toolkits/with-tools returns toolkits with a tools array for each. Useful for MCP tool selection or when you need both toolkit and tool metadata in one call. Search here applies to toolkit name, slug, and to tool name/description.

​
Query parameters (with-tools)

ParameterTypeDescription
qstringSearch keyword — Filters by toolkit name, slug, or by tool name/description. Use to search across toolkits and tools.
selectedToolSlugsstringComma-separated tool slugs; toolkits that contain these tools are returned first.
pagenumberPage number (1-based).
limitnumberItems per page (1–100). Default: 20.
sortBystringField to sort by.
sortOrderstringASC or DESC.

​
Example: search toolkits and tools by keyword

Find toolkits or tools matching “send message” or “calendar”: 
curl -X GET "https://flowra.dev/api/v1/toolkits/with-tools?q=send%20message&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Example: prioritize certain tools

Get toolkits with nested tools, with toolkits containing the given tools first: 
curl -X GET "https://flowra.dev/api/v1/toolkits/with-tools?selectedToolSlugs=slack_send_message,gmail_send_email&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Response shape

Both endpoints return a paginated response with:
  • data — Array of items (each toolkit has id, slug, name, description, logo, toolsCount, etc.; with-tools items also include a tools array).
  • meta — Pagination info (e.g. total, page, limit).

​
Browsing in the dashboard

You can browse and search toolkits in the Flowra Dashboard: open the toolkits or tools page and use the search box to filter toolkits and tools by name.
  • Workflows — Attach toolkits to workflows and agents.
  • Tools — List and execute individual tools; filter tools by toolkitSlug.
  • Tools — Search and filter tools by keyword, toolkit, and tags.
  • API reference: Toolkits — Full request/response schemas for the toolkits endpoints.