---
title: "List Sources"
method: GET
path: "/sources"
tags: ["sources"]
---

# List Sources

`GET /sources`

Retrieve all available data source connectors.

Returns the complete catalog of source types that Airweave can connect to,
including their authentication methods, configuration requirements, and
supported features. Use this endpoint to discover which integrations are
available for your organization.

Each source includes:
- **Authentication methods**: How to connect (OAuth, API key, etc.)
- **Configuration schemas**: What settings are required or optional
- **Supported auth providers**: Pre-configured OAuth providers available

## Response `200`

Successful Response

- Source[]
  - `name` string, required — Human-readable name of the data source connector (e.g., 'GitHub', 'Stripe', 'PostgreSQL').
  - `description` string, nullable — Detailed description explaining what data this source can extract and its typical use cases.
  - `auth_methods` string[], nullable — List of supported authentication methods (e.g., 'direct', 'oauth_browser').
  - `oauth_type` string, nullable — OAuth token type for OAuth sources (e.g., 'access_only', 'with_refresh').
  - `requires_byoc` boolean — Whether this OAuth source requires users to bring their own client.
  - `auth_config_class` string, nullable — Python class name that defines the authentication configuration fields required for this source (only for DIRECT auth).
  - `config_class` string, nullable — Python class name that defines the source-specific configuration options and parameters.
  - `short_name` string, required — Technical identifier used internally to reference this source type. Must be unique across all sources.
  - `class_name` string, required — Python class name of the source implementation that handles data extraction logic.
  - `output_entity_definitions` string[] — List of entity definition short names that this source can produce (e.g., ['asana_task_entity', 'asana_project_entity']).
  - `labels` string[], nullable — Categorization tags to help users discover and filter sources by domain or use case.
  - `supports_continuous` boolean — Whether this source supports cursor-based continuous syncing for incremental data extraction.
  - `federated_search` boolean — Whether this source uses federated search instead of traditional syncing.
  - `supports_temporal_relevance` boolean — Whether this source's entities have timestamps that enable recency-based ranking.
  - `supports_access_control` boolean — Whether this source supports document-level access control.
  - `rate_limit_level` string, nullable — Rate limiting level for this source: 'org' (organization-wide), 'connection' (per-connection/per-user), or None (no rate limiting).
  - `feature_flag` string, nullable — Feature flag required to access this source. If set, only organizations with this feature enabled can see/use this source.
  - `supports_browse_tree` boolean — Whether this source supports lazy-loaded browse tree for selective node syncing.
  - `auth_fields` Fields — Fields model.
    - `fields` ConfigField[], required
      - `name` string, required
      - `title` string, required
      - `description` string, nullable
      - `type` string, required
      - `required` boolean
      - `items_type` string, nullable
      - `feature_flag` string, nullable
      - `is_secret` boolean
  - `config_fields` Fields, required — Fields model.
    - `fields` ConfigField[], required
      - `name` string, required
      - `title` string, required
      - `description` string, nullable
      - `type` string, required
      - `required` boolean
      - `items_type` string, nullable
      - `feature_flag` string, nullable
      - `is_secret` boolean
  - `supported_auth_providers` string[], nullable — List of auth provider short names that support this source.

## Other responses

- `422` — Validation Error
- `429` — Rate Limit Exceeded

---

[API](https://skmtc.net/airweave-ai/apis/airweave.md) · [All operations](https://skmtc.net/airweave-ai/apis/airweave/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airweave-ai/airweave/versions/bf410c28c0c6/schema)
