List sources

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

GET /api/v1/sources

cURL

curl --request GET \
  --url 'https://upload.autorender.io/api/v1/sources?page=1&limit=10&type=image_source' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "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
  }
}

Key type: requires a private key. A public key returns 403 here, because it may only upload — see key types and scope. Call this from your server, never from browser code.

cURL

curl --request GET \
  --url 'https://upload.autorender.io/api/v1/sources?page=1&limit=10&type=image_source' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "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
  }
}

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.

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.

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

Create source

Add a new S3, Azure, Google Cloud, or image source.

Source details

Fetch the full record for one source by its id.

Authorizations

x-api-key · string · header · required

API key for public endpoints. Can also be provided via Authorization: Bearer

Query Parameters

search · string

Partial name match (case-insensitive)

type · enum<string>

Filter by source type

Available options: s3, azure, google_cloud, image_source

page · integer · default: 1

Required range: 1 <= x <= 9007199254740991

limit · integer · default: 10

Required range: 1 <= x <= 100

Response

200

application/json

Sources list

Sources list

sources · object[] · required

Show child attributes

meta · object · required

Show child attributes