> ## Documentation Index
> Fetch the complete documentation index at: https://autorender.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List sources

> Paginated sources (S3, Azure, Google Cloud, or image source) with search and type filter.

<Note>
  **Key type:** requires a private key. A public key returns `403` here, because it may only
  upload — see [key types and scope](/docs/api-reference/introduction#key-types-and-scope). Call
  this from your server, never from browser code.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://upload.autorender.io/api/v1/sources?page=1&limit=10&type=image_source' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "sources": [
      {
        "id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
        "name": "my_image_source",
        "type": "image_source",
        "configuration": {
          "base_url": "https://cdn.example.com",
          "forward_header": true
        },
        "is_active": true,
        "created_at": "2026-03-27T14:58:53.795Z",
        "updated_at": "2026-03-27T14:58:53.795Z"
      },
      {
        "id": "0a2b6b3a-3b3a-4a7a-9b0a-4a3a7a3a7a3a",
        "name": "my_s3_bucket",
        "type": "s3",
        "configuration": {
          "access_key": "****************",
          "secret_key": "****************************************",
          "region": "us-east-1",
          "bucket": "my-bucket"
        },
        "is_active": true,
        "created_at": "2026-03-20T09:12:03.221Z",
        "updated_at": "2026-03-20T09:12:03.221Z"
      }
    ],
    "meta": {
      "page": 1,
      "limit": 10,
      "total": 2,
      "hasMore": false
    }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Invalid API key.",
    "message": "The provided API key is invalid, inactive, or has been deleted"
  }
  ```
</ResponseExample>

## Overview

Returns **`sources`** (your workspace's cloud storage and image-source origins) alongside **`meta`** pagination (`page`, `limit`, `total`, `hasMore`). Filter by name with **`search`** or by **`type`**.

<Note>
  Sensitive configuration fields (`access_key`, `secret_key`, `connection_string`, `service_account_json`) are always masked in the response — the API never returns your stored secrets in plaintext.
</Note>

## Query parameters

| Parameter | Type    | Description                                           |
| --------- | ------- | ----------------------------------------------------- |
| `page`    | integer | Page number (default `1`)                             |
| `limit`   | integer | Page size, 1–100 (default `10`)                       |
| `search`  | string  | Partial, case-insensitive match on source name        |
| `type`    | string  | One of: `s3`, `azure`, `google_cloud`, `image_source` |

## Response fields

**`sources[]`:** `id`, `name`, `type`, `configuration` (secrets masked), `is_active`, `created_at`, `updated_at`

**`meta`:** `page`, `limit`, `total`, `hasMore`

## Next steps

<CardGroup cols={2}>
  <Card title="Create source" icon="plus" iconType="solid" href="/docs/api-reference/create-source">
    Add a new S3, Azure, Google Cloud, or image source.
  </Card>

  <Card title="Source details" icon="circle-info" iconType="solid" href="/docs/api-reference/get-source-details">
    Fetch the full record for one source by its id.
  </Card>
</CardGroup>