Create source

Create a new source: S3, Azure, Google Cloud, or image source.

POST /api/v1/sources

cURL (image_source)

curl --request POST \
  --url 'https://upload.autorender.io/api/v1/sources' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "my_image_source",
  "type": "image_source",
  "configuration": {
    "base_url": "https://cdn.example.com",
    "forward_header": true
  }
}'

201

{
  "success": true,
  "data": {
    "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"
  }
}

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 (image_source)

curl --request POST \
  --url 'https://upload.autorender.io/api/v1/sources' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "my_image_source",
  "type": "image_source",
  "configuration": {
    "base_url": "https://cdn.example.com",
    "forward_header": true
  }
}'

201

{
  "success": true,
  "data": {
    "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"
  }
}

Overview

Creates a source in your workspace. Send name, type, and a configuration object shaped for that type — the API validates the configuration against the type before creating the row.

Request body

Field	Type	Required	Description
name	string	Yes	Letters, numbers, underscores, and hyphens only. Must be unique in the workspace.
type	string	Yes	One of: s3, azure, google_cloud, image_source
configuration	object	Yes	Type-specific fields (see below)

Configuration by type

Type	Fields
s3	access_key, secret_key, region (required), bucket (required)
azure	connection_string (required), container_name (required)
google_cloud	service_account_json (required), bucket_name (required)
image_source	base_url (required, no trailing /), canonical_header, forward_header (boolean)

Response

The created source, wrapped as { "success": true, "data": { ... } }. Sensitive fields are masked in the response even though they were just set.

Next steps

List sources

Browse the sources in your workspace.

Update source

Change a source’s name or configuration.

Authorizations

x-api-key · string · header · required

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

Body

application/json

name · string · required

Source name (letters, numbers, underscores, hyphens)

Required string length: 1 - 255

Pattern: ^[a-zA-Z0-9_-]+$

type · enum<string> · required

Available options: s3, azure, google_cloud, image_source

configuration · object · required

Type-specific configuration payload

Show child attributes

Response

201

application/json

Source created

Source created

success · enum<boolean> · required

Available options: true

data · object · required

Show child attributes