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
curl https://api.gumlet.com/v1/image/sources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "type": "webfolder",
  "webfolder": {
    "base_url": "https://www.google.com"
  },
  "namespace": "google-demo"
}'

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