Create Source

​

This endpoint allows users to create image source.

Body
application/json
  • namespace
    Type: string
    required

    unique subdomain associated with the image source

  • type
    Type: string enum
    required
    values
    • proxy
    • webfolder
    • aws
    • gcs
    • dostorage
  • aws
    Type: object

    This is a required field if source type is aws.

  • azure
    Type: object

    This is a required field if source type is azure.

  • backblaze
    Type: object

    This is a required field if source type is backblaze.

  • cloudflare
    Type: object

    This is a required field if source type is cloudflare.

  • cloudinary
    Type: object

    This is a required field if source type is cloudinary.

  • dostorage
    Type: object

    This is a required field if source type is dostorage.

  • gcs
    Type: object

    This is a required field if source type is gcs.

  • linode
    Type: object

    This is a required field if source type is linode.

  • proxy
    Type: object

    This is a required field if source type is proxy.

  • wasabi
    Type: object

    This is a required field if source type is wasabi.

Responses
  • application/json
  • application/json
Request Example for post/image/sources
import Gumlet from '@gumlet/nodejs-sdk';

const client = new Gumlet({
  apiKey: process.env['API_KEY'], // defaults to the API_KEY env var
});

const imageSource = await client.imageSources.create({
  type: 'webfolder',
  webfolder: { base_url: 'https://www.google.com' },
  namespace: 'google-demo',
});

console.log(imageSource);

{
  "id": "6a849ee1ed1e919cbba62a7e",
  "namespace": "google-demo",
  "type": "webfolder",
  "cdn_type": "third_party",
  "cdn_cache_time": 8640000,
  "canonical_url": true,
  "browser_cache_time": 8640000,
  "is_cloudfront": false,
  "created_at": "2026-08-18T18:05:21.565Z",
  "updated_at": "2026-08-18T18:05:21.565Z",
  "webfolder": {
    "base_url": "https://www.google.com"
  },
  "default_params": {
    "format": "auto",
    "compress": "true"
  },
  "subdomain": "google-demo.gumlet.io",
  "is_active": true
}

200