v1

latestOpenAPI 3.1.02026-07-2352630.4 KB
apps

List Apps

List available apps with filtering options.

Apps are curated, runnable applications built on top of flows. Each app exposes a set of configured inputs and produces one or more outputs, and can be executed directly via POST /app-runs.

Filtering Options:

  • visibility: Filter apps by their visibility status (can be provided multiple times) Options include:
    • private: Only visible to the creator
    • workspace: Visible to everyone in the creator's organization
    • shared: Visible via a shared link
    • public: Visible to everyone By default, all apps accessible to the caller are returned.
  • search: Search apps by name or description (case-insensitive)

Pagination Parameters:

  • limit: Maximum number of items to return (default: 20, max: 100)
  • cursor: Cursor for pagination (optional)

Response:

  • data: List of app summaries with basic information including expected inputs
  • has_more: Indicates if there are more results available
  • next_cursor: Cursor for the next page of results

Use Case: This is typically the first endpoint called to discover available apps before getting detailed information or executing them.

get/apps/

Query parameters

visibilityFlowApplicationVisibility[] nullable
searchstring nullable

Search apps by name or description

Search apps by name or description

limitinteger

Maximum number of items to return

Maximum number of items to return

cursorstring nullable

Cursor for pagination (from next_cursor)

Cursor for pagination (from next_cursor)

Headers

X-Organization-Idstring nullable

Active organization ID for multi-org support

Active organization ID for multi-org support

Response

Successful Response

has_moreboolean required
next_cursorstring nullable