> ## 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.

# Create source

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

<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 (image_source) theme={null}
  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
    }
  }'
  ```

  ```bash cURL (s3) theme={null}
  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_s3_bucket",
    "type": "s3",
    "configuration": {
      "access_key": "AKIA...",
      "secret_key": "secret...",
      "region": "us-east-1",
      "bucket": "my-bucket"
    }
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "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"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Validation failed",
    "message": "Configuration is invalid for the specified type"
  }
  ```

  ```json 409 theme={null}
  {
    "error": "Origin name already exists in this workspace"
  }
  ```
</ResponseExample>

## 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

<CardGroup cols={2}>
  <Card title="List sources" icon="list" iconType="solid" href="/docs/api-reference/list-sources">
    Browse the sources in your workspace.
  </Card>

  <Card title="Update source" icon="pen" iconType="solid" href="/docs/api-reference/update-source">
    Change a source's name or configuration.
  </Card>
</CardGroup>