> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowra.dev/llms.txt > Use this file to discover all available pages before exploring further. # List connected accounts > Returns all OAuth-connected accounts (e.g. Google, Slack) linked to your project. Use these when workflows or agents need to act on behalf of a connected user. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/connected_accounts openapi: 3.0.0 info: title: Flowra API (API Key Endpoints) description: >- **Flowra** is an AI-powered platform for building agents, workflows, and integrations. ### Capabilities - **Tools & Toolkits** – Define and group tools for agents and workflows. - **Workflows** – Orchestrate steps and automate processes. - **Triggers** – Schedule or event-based execution. - **Auth & Connections** – OAuth, API keys, and connected accounts. - **MCP** – Model Context Protocol server integration. - **Knowledge / RAG** – Add files and URLs for retrieval-augmented generation. ### Authentication Use the **x-api-key** header with a project API key to access endpoints that support API Key auth. Create and manage API keys in the dashboard under your project settings. Only endpoints that support API Key authentication via the @ApiKeyEnabled() decorator. Send x-api-key (required). On multi-tenant endpoints, optionally send x-username to act as an external user. Only endpoints that support API Key authentication via the @ApiKeyEnabled() decorator. Send x-api-key (required). On multi-tenant endpoints, optionally send x-username (defaults to the project’s default external user). version: '1.0' contact: name: Flowra url: https://flowra.dev servers: - url: https://flowra.dev description: Flowra API security: [] tags: - name: Users description: User profile - name: External Users description: End-user identities inside a project (x-username) - name: Auth Configs description: OAuth and API key configs for toolkits - name: Connected Accounts description: OAuth connected accounts and link creation - name: Toolkits description: List and search toolkits - name: Tools description: List, execute, and manage tools - name: Skills description: Browse, create, import, and install skills - name: Workflow & Agent description: Create, run, and inspect workflows and agents - name: Triggers description: Schedule and event-based trigger instances - name: Chat description: Threads and streaming agent runs - name: File description: Upload, list, and download files - name: Knowledge description: RAG knowledge collections - name: Table description: Collections and documents - name: Sandbox description: Ephemeral and durable code sandboxes - name: Browser description: Live browser sessions and view - name: LLM description: List AI models and generate completions - name: MCP description: MCP server management paths: /api/v1/connected_accounts: get: tags: - Connected Accounts summary: List connected accounts description: >- Returns all OAuth-connected accounts (e.g. Google, Slack) linked to your project. Use these when workflows or agents need to act on behalf of a connected user. operationId: ConnectedAccountsController_getConnectedAccounts parameters: - name: toolkitSlugs required: false in: query description: The toolkit slugs of the connected accounts schema: type: array items: type: string - name: statuses required: false in: query description: The status of the connected account schema: type: array items: $ref: '#/components/schemas/ConnectedAccountStatus' - name: cursor required: false in: query description: The cursor to paginate through the connected accounts schema: type: string - name: limit required: false in: query description: The limit of the connected accounts to return schema: default: 10 type: number - name: eUIDs required: false in: query description: The external user ids (eUID) of the connected accounts schema: type: array items: type: string - name: authConfigIds required: false in: query description: The auth config ids of the connected accounts schema: type: array items: type: string - name: connectedAccountIds required: false in: query description: The connected account ids to filter by schema: type: array items: type: string - name: orderBy required: false in: query description: The order by of the connected accounts schema: enum: - createdAt - updatedAt type: string - name: orderDirection required: false in: query description: The order direction of the connected accounts schema: enum: - asc - desc type: string - name: labels required: false in: query description: The labels of the connected accounts schema: type: array items: type: string - name: x-username in: header required: false description: >- External user (end user) to act as. Optional — if omitted, Flowra uses the project’s default external user. Send a stable username (e.g. customer_alice) only when you need another end-user context. schema: type: string default: (project default user) example: customer_alice responses: '200': description: Successfully retrieved connected accounts content: application/json: schema: $ref: '#/components/schemas/GetConnectedAccountsResponseDto' '400': description: Bad request '401': description: Unauthorized '422': description: Unprocessable entity '500': description: Internal server error security: - x-api-key: [] - x-api-key: [] x-username: [] components: schemas: ConnectedAccountStatus: $ref: '#/components/schemas/ConnectedAccountStatus' type: string enum: - INITIALIZING - INITIATED - ACTIVE - FAILED - EXPIRED - INACTIVE GetConnectedAccountsResponseDto: $ref: '#/components/schemas/GetConnectedAccountsResponseDto' type: object properties: items: description: List of connected accounts type: array items: $ref: '#/components/schemas/ConnectedAccountItemDto' nextCursor: type: string description: Next page cursor example: eyJwYWdlIjoyLCJsaW1pdCI6MTB9 totalPages: type: number description: Total number of pages example: 5 currentPage: type: number description: Current page number example: 1 totalItems: type: number description: Total number of items example: 50 required: - items - nextCursor - totalPages - currentPage - totalItems securitySchemes: x-api-key: type: apiKey in: header name: x-api-key description: >- Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: x-username: type: apiKey in: header name: x-username description: >- Optional. External user username. If omitted, Flowra uses the project’s default external user. Send as header: x-username: ````