Update source

Partially update a source by its id.

PATCH /api/v1/sources/{sourceId}

cURL

curl --request PATCH \
  --url 'https://upload.autorender.io/api/v1/sources/974628c2-9b55-4ce4-adf1-9b63edff6baa' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "renamed_source"
}'

200

{
  "success": true,
  "data": {
    "id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
    "name": "renamed_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-28T09:03:11.402Z"
  }
}

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 PATCH \
  --url 'https://upload.autorender.io/api/v1/sources/974628c2-9b55-4ce4-adf1-9b63edff6baa' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "renamed_source"
}'

200

{
  "success": true,
  "data": {
    "id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
    "name": "renamed_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-28T09:03:11.402Z"
  }
}

Overview

Partially updates the source identified by sourceId. Both fields are optional — send only what changes. When configuration is provided, its fields are merged into the existing configuration rather than replacing it, and previously-masked secret fields you send back unchanged (e.g. "****") are left untouched.

Path parameters

Parameter	Description
sourceId	Source id (UUID) to update

Request body

Field	Type	Required	Description
name	string	No	New name — letters, numbers, underscores, and hyphens only. Must be unique in the workspace.
configuration	object	No	Fields to merge into the existing configuration

Response

The updated source, wrapped as { "success": true, "data": { ... } }.

Next steps

Source details

Fetch the current state of a source.

Delete source

Permanently remove a source from your workspace.

Authorizations

x-api-key · string · header · required

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

Path Parameters

sourceId · string<uuid> · required

Source ID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json

name · string

Required string length: 1 - 255

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

configuration · object

Fields to merge into the existing configuration

Show child attributes

Response

200

application/json

Updated source

Updated source

success · enum<boolean> · required

Available options: true

data · object · required

Show child attributes