SuperAI Flow Platform

Sections

Theme switcher

List credentials by provider

Retrieve user credentials filtered by integration provider.

Returns credentials for a specific integration provider. This is useful when you need to find credentials for a particular service without fetching all credentials.

Context: This endpoint provides filtered access to credentials, commonly used when: - Checking if a user has connected to a specific provider (e.g., SharePoint) - Populating provider-specific integration configuration UI - Validating credential availability before initiating provider-specific workflows - Building provider selection dropdowns with availability indicators

Use Cases: Check if user has SharePoint credentials before showing SharePoint site picker.

Filter credentials for Google provider to display connected Google accounts in UI.

Validate SFTP credential availability before configuring file upload task.

Related Endpoints: - GET /integrations/credentials - Get all credentials (unfiltered) - POST /integrations/credentials - Create new credential for a provider - GET /integrations/catalog - List all available providers

Notes: - Provider names are case-insensitive but lowercase is recommended - Multiple credentials per provider are supported (e.g., multiple SFTP servers) - Soft-deleted credentials are excluded from results

Header Parameters

Authorizationstring

Path Parameters

providerstring Required

Integration provider to filter credentials by. Valid providers: microsoft, sharepoint, sftp, aws_ses, google, postgresql, internal_postgresql. Returns only credentials matching the specified provider.

Enum values:
microsoftsharepointsftpaws_sesgooglepostgresqlinternal_postgresql

Response

200
Object
List of credentials for the specified provider retrieved successfully

Response Attributes

created_atstring Required
google_emailnull
idstring Required
modified_bystring Required
providerstring Required

API-friendly version of ProviderEnum without spaces

Enum values:
microsoftsharepointsftpaws_sesgooglepostgresqlinternal_postgresql
updated_atstring Required
user_idnull
400
Object
Invalid provider

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
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
422
Object
Validation Error

Response Attributes

detailarray

Show child attributes

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