How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Super.ai integrations API

Integration operations for connecting flows to external services and platforms.Integrations enable your workflows to interact with third-party services, databases, storage systems, and communication platforms. They provide a unified interface for managing credentials, testing connections, and configuring service-specific features.**Supported integration types:**- **Databases**: PostgreSQL, MySQL, and other SQL databases- **Storage**: SFTP, cloud storage, and file systems- **Communication**: Email (SMTP, SES), webhooks, notifications- **Collaboration**: SharePoint, Google Drive, document management- **Custom**: Plugin architecture for extending functionality**Key concepts:**- **Credentials**: Securely stored authentication information per integration- **Plugins**: Modular integration implementations with discovery and registration- **OAuth Flows**: Automated authorization for third-party services- **Webhooks**: Inbound event handling from external platforms- **Connection Testing**: Validate credentials and connectivity before use**Use these endpoints to:**- Configure and manage integration credentials- Test connections to external services- Handle OAuth authorization flows for cloud services- Set up and manage webhooks for inbound events- Discover available integration capabilities- Access integration-specific features (folders, schemas, etc.)Integrations bridge your workflows with the external world, enabling powerful automation across your entire technology stack.

Super.ai integrations API is one of 19 APIs that Super.ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Integration. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and authentication docs.

This API exposes 50 operations across 42 paths, and defines 45 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against a single base URL, https://flows.super.ai/api.

50 operations 42 paths 45 schemas 5 DELETE22 GET1 PATCH22 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://flows.super.ai/api
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Super.ai integrations API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). An API key is passed in the header as X-API-Key (APIKeyAuth).

  • BearerAuth — JWT Bearer token authentication. Include your access token in the Authorization header as: Bearer YOURACCESSTOKEN Example: Authorization: Bearer eyJhbGciOiJIUz…
  • APIKeyAuth — API key authentication. Include your API key in the X-API-Key header as: X-API-Key YOURAPIKEY Example: X-API-Key: saf1234567890

Paths & Operations 50

Across 42 paths, the API surfaces 50 operations — 5 DELETE, 22 GET, 1 PATCH, 22 POST. Each is listed below with its method, path, parameters, and response codes.

integrations 50

Integration operations for connecting flows to external services and platforms. Integrations enable your workflows to interact with third-party services, databases, storage system…

GET
/api/integrations/database
List user databases
list_databases_api_integrations_database_get → 200401500
POST
/api/integrations/database
Create Database
create_database_api_integrations_database_post body → 200422
POST
/api/integrations/database/managed
Create managed database
create_managed_database_api_integrations_database_managed_post → 201409401500
GET
/api/integrations/database/managed/tables
List tables in managed database
list_managed_database_tables_api_integrations_database_managed_tables_get → 200404401500
POST
/api/integrations/database/managed/tables
Create table in managed database
create_managed_database_table_api_integrations_database_managed_tables_post body → 201400401500422
GET
/api/integrations/database/managed/tables/{table_name}/columns
Get table columns from managed database
get_managed_database_table_columns_api_integrations_database_managed_tables__table_name__columns_get 1 param → 200404401500422
GET
/api/integrations/database/managed/tables/{table_name}/data
Get table data from managed database
get_managed_database_table_data_api_integrations_database_managed_tables__table_name__data_get 1 param → 200404401500422
POST
/api/integrations/database/managed/tables/{table_name}/rows
Insert one row into a managed-DB table
insert_managed_database_row_api_integrations_database_managed_tables__table_name__rows_post 1 param body → 201400404409422401500
POST
/api/integrations/database/managed/tables/{table_name}/query
Query a managed-DB table with exact-match filters
query_managed_database_table_api_integrations_database_managed_tables__table_name__query_post 1 param body → 200400404422401500
GET
/api/integrations/database/{db_id}
Get database by ID
get_database_api_integrations_database__db_id__get 1 param → 200404401500422
DELETE
/api/integrations/database/{db_id}
Delete database
delete_database_api_integrations_database__db_id__delete 1 param → 200404401403500422
GET
/api/integrations/database/{db_id}/download
Get Download Url
get_download_url_api_integrations_database__db_id__download_get 1 param → 200422
GET
/api/integrations/database/{db_id}/columns
Get database columns
get_database_columns_api_integrations_database__db_id__columns_get 1 param → 200404401500422
POST
/api/integrations/database/{db_id}/upload-url
Generate database upload URL
generate_database_upload_url_api_integrations_database__db_id__upload_url_post 2 params → 200404401500422
POST
/api/integrations/database/{db_id}/upload/preview
Preview CSV file before import
preview_csv_upload_api_integrations_database__db_id__upload_preview_post 1 param body → 200400404401500422
POST
/api/integrations/database/{db_id}/upload/compare
Compare Csv For Replace
compare_csv_for_replace_api_integrations_database__db_id__upload_compare_post 1 param body → 200422
POST
/api/integrations/database/{db_id}/upload/complete
Complete File Upload
complete_file_upload_api_integrations_database__db_id__upload_complete_post 1 param body → 200422
POST
/api/integrations/database/{db_id}/upload/replace
Replace File Upload
replace_file_upload_api_integrations_database__db_id__upload_replace_post 1 param body → 200422
GET
/api/integrations/database/health
Get Database Integration Health
get_database_integration_health_api_integrations_database_health_get → 200
POST
/api/integrations/postgres/test-connection
Test Postgres Connection
test_postgres_connection_api_integrations_postgres_test_connection_post body → 200422
POST
/api/integrations/postgres/test-connection/{credential_id}
Test Postgres Connection By Credential Id
test_postgres_connection_by_credential_id_api_integrations_postgres_test_connection__credential_id__post 1 param → 200422
POST
/api/integrations/email/tasks
Create Email Task
create_email_task_api_integrations_email_tasks_post body → 200422
DELETE
/api/integrations/email/tasks
Deactivate Email Task
deactivate_email_task_api_integrations_email_tasks_delete 1 param → 204422
GET
/api/integrations/email/tasks/{task_id}
Get Email Task Status
get_email_task_status_api_integrations_email_tasks__task_id__get 1 param → 200422
POST
/api/integrations/email/process
Process Emails
process_emails_api_integrations_email_process_post → 200
GET
/api/integrations/email/health
Get Email Integration Health
get_email_integration_health_api_integrations_email_health_get → 200
GET
/api/integrations/credentials
List user credentials
get_user_credentials_api_integrations_credentials_get → 200401403500
POST
/api/integrations/credentials
Create integration credentials
create_user_credentials_api_integrations_credentials_post body → 201400403401500422
GET
/api/integrations/credentials/provider/{provider}
List credentials by provider
get_user_credentials_by_provider_api_integrations_credentials_provider__provider__get 1 param → 200400401403500422
GET
/api/integrations/credentials/{credential_id}/credentials
Get credential secrets
get_credential_secrets_api_integrations_credentials__credential_id__credentials_get 1 param → 200400403404401500422
GET
/api/integrations/credentials/{credential_id}
Get credential by ID
get_user_credential_api_integrations_credentials__credential_id__get 1 param → 200400404401403500422
DELETE
/api/integrations/credentials/{credential_id}
Delete credential
delete_user_credential_api_integrations_credentials__credential_id__delete 1 param → 204400404401403500422
PATCH
/api/integrations/credentials/{credential_id}
Update credential
update_user_credential_api_integrations_credentials__credential_id__patch 1 param body → 200400404401403500422
GET
/api/integrations/plugins/
List all registered plugins
list_plugins_api_integrations_plugins__get → 200401500
GET
/api/integrations/plugins/{plugin_name}/capabilities
Get plugin capabilities
get_plugin_capabilities_api_integrations_plugins__plugin_name__capabilities_get 1 param → 200404401500422
POST
/api/integrations/plugins/{plugin_name}/oauth/authorize
Oauth Authorize Legacy
oauth_authorize_legacy 1 param body → 200422
GET
/api/integrations/plugins/{plugin_name}/oauth/callback
Oauth Callback Legacy
oauth_callback_legacy 4 params → 200422
POST
/api/integrations/plugins/{plugin_name}/instances
Create Integration Legacy
create_integration_legacy_api_integrations_plugins__plugin_name__instances_post 1 param body → 200422
GET
/api/integrations/plugins/{plugin_name}/instances
List Integration Instances
list_integration_instances_api_integrations_plugins__plugin_name__instances_get 4 params → 200422
DELETE
/api/integrations/plugins/{plugin_name}/instances/{integration_id}
Delete Integration Legacy
delete_integration_legacy_api_integrations_plugins__plugin_name__instances__integration_id__delete 2 params → 200422
POST
/api/integrations/plugins/{plugin_name}/instances/{integration_id}/webhook/callback
Handle Webhook Legacy
handle_webhook_legacy_api_integrations_plugins__plugin_name__instances__integration_id__webhook_callback_post 2 params → 200422
POST
/api/integrations/plugins/{plugin_name}/instances/{integration_id}/files/move
Move File
move_file_api_integrations_plugins__plugin_name__instances__integration_id__files_move_post 2 params → 200422
DELETE
/api/integrations/plugins/{plugin_name}/instances/{integration_id}/files
Delete File
delete_file_api_integrations_plugins__plugin_name__instances__integration_id__files_delete 2 params → 200422
GET
/api/integrations/plugins/{plugin_name}/folders
List Folders
list_folders_api_integrations_plugins__plugin_name__folders_get 2 params → 200422
GET
/api/integrations/plugins/sharepoint/sites
Get Sharepoint Sites
get_sharepoint_sites_api_integrations_plugins_sharepoint_sites_get 1 param → 200422
GET
/api/integrations/plugins/sharepoint/drives
Get Sharepoint Drives
get_sharepoint_drives_api_integrations_plugins_sharepoint_drives_get 2 params → 200422
POST
/api/integrations/sftp/test-connection
Test Sftp Connection
test_sftp_connection_api_integrations_sftp_test_connection_post body → 200422
GET
/api/integrations/catalog
List integration catalog
get_integration_catalog_api_integrations_catalog_get → 200401403500
POST
/api/integrations/plugins/postgres/test-connection
Test Postgres Plugin Connection
test_postgres_plugin_connection_api_integrations_plugins_postgres_test_connection_post body → 200422
POST
/api/integrations/plugins/postgres/execute
Execute Postgres Plugin Task
execute_postgres_plugin_task_api_integrations_plugins_postgres_execute_post body → 200422

Schemas 45

The contract defines 45 schemas that model the data the API accepts and returns. The most detailed are DocumentFileResponse (12 properties), IntegrationCatalogResponse (9 properties), SftpTestConnectionRequest (8 properties), CredentialsResponse (7 properties). Each schema is shown below with its type and property counts.

SftpTestConnectionRequest
object
Request model for testing SFTP connection.
8 properties 3 required
DatabaseColumnsResponse
object
Response containing database column information. Returned by GET /database/{dbid}/columns endpoint.
3 properties 3 required
QueryTableRequest
object
Request to query a managed-DB table with exact-match clauses and a row limit.
4 properties
QueryTableResponse
object
Response containing matched rows from a managed-DB table.
4 properties 4 required
TableInfo
object
Information about a database table.
2 properties 2 required
CreateTableResponse
object
Response after creating a table.
4 properties 4 required
IntegrationCategory
string
Integration category
CSVPreviewResponse
object
Response containing CSV file preview. Returned by POST /database/{dbid}/upload/preview endpoint. Shows first 5 rows and file metadata before final upload.
3 properties 3 required
PostgresCreateRequest
object
PostgreSQL integration creation request model.
6 properties 5 required
OrderByColumn
object
Order by a named column in ASC or DESC direction.
3 properties 1 required
IntegrationCatalogResponse
object
Response model for integration catalog
9 properties 6 required
TableListResponse
object
Response containing list of tables in a managed database.
2 properties 1 required
FileUploadCompleteRequest
object
Request to complete file upload and process the file.
4 properties 1 required
UserIntegrationCredentialsCreate
object
Request model for creating user integration credentials
4 properties 4 required
DocumentFileResponse
object
Response for document file operations.
12 properties 6 required
DocumentFileCreateRequest
object
Request to create a new document file entry.
5 properties 1 required
UserIntegrationCredentialsUpdate
object
Request model for updating user integration credentials
3 properties 2 required
TableDataResponse
object
Response containing table data.
5 properties 5 required
ErrorResponse
object
Standard API error response structure. All error responses from the API follow this format, ensuring consistent error handling for API consumers. Example: { "e…
2 properties 1 required
IsNullMatch
object
Match clause for NULL values: "col" IS NULL. Use this in place of trying to match value: null — WHERE col = NULL is always false in SQL.
2 properties 1 required
ValidationError
object
3 properties 3 required
app__api__integrations__plugins__plugins_router__OauthAuthorizeRequest
object
2 properties 2 required
ErrorDetail
object
Standard error detail structure. This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
3 properties 1 required
ColumnDefinition
object
Definition of a table column.
5 properties 2 required
EmailTaskResponse
object
Response from email task creation.
5 properties 3 required
InsertRowRequest
object
Request to insert a single row into a managed-DB table.
1 property 1 required
CreateTableRequest
object
Request to create a new table in a managed database.
2 properties 2 required
ProviderApiEnum
string
CredentialTypeEnum
string
UploadUrlResponse
object
Response containing pre-signed upload URL for file uploads. Generated by POST /database/{dbid}/upload-url endpoint. Use this URL to upload files directly to cl…
3 properties 2 required
EmailTaskStatus
object
Status of an email task.
6 properties 4 required
ForeignKeyDefinition
object
Foreign key constraint definition.
2 properties 2 required
HTTPValidationError
object
1 property
JsonKeysMatch
object
Match clause against keys inside a JSONB column: "col"-'k' = :param.
4 properties 2 required
TableColumnsResponse
object
Response containing columns of a table.
2 properties 2 required
DatabaseDownloadResponse
object
Response containing download URL for database file.
1 property 1 required
TableColumn
object
Information about a table column.
2 properties 2 required
KeyValue
object
One JSON key/value pair inside a jsonkeys match clause.
2 properties 2 required
EmailTaskRequest
object
Request to create an email task.
4 properties 1 required
InsertRowResponse
object
Response containing the inserted row.
2 properties 2 required
CredentialProvider
object
Credential provider model
3 properties 3 required
OrderByRandom
object
Order by random() for uniform random sampling across the matched pool. Pushing the randomisation into Postgres is the only way to get a uniform sample over the…
1 property
CSVMetadata
object
Metadata about a CSV file.
6 properties 6 required
WholeMatch
object
Exact-match clause on a column value: "col" = :param.
3 properties 2 required
CredentialsResponse
object
7 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

superai-integrations-api-openapi.yml Raw ↑

Other APIs Super.ai publishes across the network.

Super.ai auth API
Super.ai files API
Super.ai flow-executions API
Super.ai flows API
Super.ai human-review-tasks API
Super.ai models API
Super.ai organizations API
Super.ai plugins API
Super.ai profile API
Super.ai service-accounts API
Super.ai sso API
Super.ai task-data API
Where this information came from

This is an independent, third-party profile of Super.ai integrations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.