SuperAI Flow Platform

Sections

Theme switcher

List integration catalog

Retrieve the catalog of available third-party integrations.

Returns a comprehensive list of all integration providers supported by SuperAI Flows. Each integration includes metadata about authentication requirements, capabilities, and categorization to help users discover and connect external services to their workflows.

Context: - The integration catalog is the primary discovery mechanism for available services - Dynamically generated from the plugin registry (no database storage overhead) - All authenticated users can access the catalog - Automatically excludes credentialless integrations and integrations in migration

Integration Categories: - database: PostgreSQL, internal PostgreSQL database connectors - storage: SharePoint document libraries, SFTP file servers - messaging: AWS SES email integration - automation: Various task executors and workflow automation tools

Authentication Methods: - oauth2: OAuth 2.0 authorization flow (Google, SharePoint, Microsoft) - user_password: Username/password authentication (SFTP, PostgreSQL) - api_key: API key-based authentication - key_file: SSH key-based authentication (SFTP)

Use Cases: - Display available integrations in UI marketplace - Show available connectors during flow task configuration - Validate provider support before connection attempts - Determine authentication requirements before OAuth flows - Populate provider selection dropdowns

Related Endpoints: - GET /integrations/plugins - List detailed plugin metadata - GET /integrations/plugins/{plugin_name}/capabilities - Get plugin capabilities - POST /integrations/credentials - Create credentials for integration - GET /integrations/credentials - List user's configured credentials

Notes: - OAuth integrations require additional authorize/callback flow - Integration availability ≠ user has configured credentials - Plugin system allows custom integrations without code changes - Use GET /integrations/credentials to check user's connections

Header Parameters

Authorizationstring

Response

200
Object
Integration catalog retrieved successfully

Response Attributes

categorystring Required

Integration category

Enum values:
automationhuman_in_the_loopdatabasemessagingagent_in_the_loopstorage
credential_typesarray Required
Enum values:
api_keygoogle_oauthsharepoint_oauthoauth2user_passwordkey_file

Show child attributes

descriptionstring Required
idstring Required
is_pluginboolean
Default value
false
namestring Required
providerstring Required

API-friendly version of ProviderEnum without spaces

Enum values:
microsoftsharepointsftpaws_sesgooglepostgresqlinternal_postgresql
401
Object
Unauthorized - Missing or invalid authentication credentials

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
403
Object
Forbidden - Insufficient permissions to access this resource

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
500
Object
Internal Server Error - An unexpected error occurred

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
Was this section helpful?

What made this section unhelpful for you?

GET

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot