---
title: "List retrieval sources"
method: GET
path: "/v1/projects/{project_id}/retrieval/sources"
tags: ["retrieval"]
---

# List retrieval sources

`GET /v1/projects/{project_id}/retrieval/sources`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/retrieval/sources`
- Auth: HTTP bearer

List the external retrieval sources connected to an environment, oldest first. Credentials are not returned.

Required permission: `retrieval.view`.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `environment_id` string, uuid, required: Environment ID from `GET /environments`.

## Response `200`

Successful Response

- RetrievalSourceResponse[]
  - `id` string, required
  - `environment_id` string, required: Environment the source syncs into.
  - `type` string, required: Source type: `notion`, `confluence` (Confluence Cloud), `coda` (Superhuman Docs), `zendesk` (Zendesk Help Center), or `website`.
  - `name` string, required
  - `config` object, required: Provider settings without `integration_token` and `api_token`.
  - `status` string, required: `active`, or `error` after a failed sync. Updating `config` resets `error` to `active`.
  - `last_synced_at` string, nullable, required: Start time of the most recent successful sync; null until one succeeds.
  - `last_error` string, nullable, required: Message from the most recent sync that failed or was skipped, or a JSON string with a `file_issues` list when it completed with file problems; null otherwise.
  - `created_at` string, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/connic/apis/connic-api.md) · [All operations](https://skmtc.dev/connic/apis/connic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/connic/apis/connic-api/revisions/482932da5fbe?raw)