LogoLogo
  • Overview
  • Quick Start
  • Authentication
  • Rate limits
  • Errors
  • Image Editing API
    • Image I/O
    • Image Operations
      • Restorations
      • Resizing
      • Outpainting
      • Generative Editing
      • Color Adjustments
      • Background
      • Padding
      • Privacy
    • API Reference
    • Async API Reference
    • Batch API Reference
    • Upload API Reference
  • image generation api
    • Image Generation I/O
    • Image Generation Options
    • API Reference
  • AI Background API
    • AI Background I/O
    • AI Background Options
      • Object
      • Scene
      • Product Shadow
    • API Reference
  • Image to Video API
    • Image to Video I/O
    • Image to Video Options
    • Async API Reference
  • Storage Connectors
    • Overview
    • AWS S3
    • Google Cloud Storage
    • Web Folder
    • API Reference
  • Guides
    • E-commerce
    • Real Estate
    • Printing
  • Redoc
  • Blog
Powered by GitBook
On this page
Edit on GitHub
  1. Storage Connectors

API Reference

PreviousWeb FolderNextE-commerce

Last updated 1 year ago

Get Storage types

Request

GET /v1-beta1/storage/storage-types HTTP/1.1
Host: api.claid.ai
Authorization: Bearer {YOUR_API_KEY}
curl -X GET --location "https://api.claid.ai/v1-beta1/storage/storage-types" --http1.1 \
    -H "Host: api.claid.ai" \
    -H "Authorization: Bearer {YOUR_API_KEY}"

Response body

{
  "data": [
    "web_folder",
    "s3",
    "gcs"
  ]
}

Get Connected Storages

Request

GET /v1-beta1/storage/storages HTTP/1.1
Host: api.claid.ai
Authorization: Bearer {YOUR_API_KEY}
curl -X GET --location "https://api.claid.ai/v1-beta1/storage/storages" --http1.1 \
    -H "Host: api.claid.ai" \
    -H "Authorization: Bearer {YOUR_API_KEY}"

Response body

{
  "data": [
    {
      "id": 1,
      "name": "s3-playground",
      "type": "s3",
      "parameters": {
        "path": "/input/",
        "bucket": "playground"
      },
      "created_at": "2022-01-10T18:27:16.362118+00:00"
    },
    {
      "id": 2,
      "name": "designer-uploads",
      "type": "gcs",
      "parameters": {
        "path": "",
        "bucket": "image-uploads"
      },
      "created_at": "2022-01-10T18:28:22.100041+00:00"
    }
  ]
}

Create a new Claid Storage

Here is an example of creating AWS storage via API:

Request

POST /v1-beta1/storage/storages
Host: api.claid.ai
Authorization: Bearer {YOUR_API_KEY}
Content-Type: application/json

{
  "name": "s3-playground",
  "type": "s3",
  "parameters": {
    "bucket": "playground",
    "credentials": {
      "access_key": "AKIAXXXXXXX",
      "secret_access_key": "YourSecretAccessKey"
    }
  }
}
curl -X POST --location "https://api.claid.ai/v1-beta1/storage/storages" \
    -H "Host: api.claid.ai" \
    -H "Authorization: Bearer {YOUR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d "{
          \"name\": \"s3-playground\",
          \"type\": \"s3\",
          \"parameters\": {
            \"bucket\": \"playground\",
            \"credentials\": {
              \"access_key\": \"AKIAXXXXXXX\",
              \"secret_access_key\": \"YourSecretAccessKey\"
            }
          }
        }"

Response body

{
  "data": {
    "id": 1,
    "name": "s3-playground",
    "type": "s3",
    "parameters": {
      "path": "",
      "bucket": "playground"
    },
    "created_at": "2022-05-10T10:29:12.754824+00:00"
  }
}

parameters supported by the AWS S3 storage:

Parameter
Type

name

string

bucket

string

prefix

string

credentials.access_key

string

credentials.secret_access_key

string

name

string

bucket

string

prefix

string

credentials.access_key

string

credentials.secret_access_key

string

name

string

base_url

string

Describe storage by id

Request

GET /v1-beta1/storage/storages/1 HTTP/1.1
Host: api.claid.ai
Authorization: Bearer {YOUR_API_KEY}
curl -X GET --location "https://api.claid.ai/v1-beta1/storage/storages/1" --http1.1 \
    -H "Host: api.claid.ai" \
    -H "Authorization: Bearer {YOUR_API_KEY}"

Response body

{
  "data": {
    "id": 1,
    "name": "s3-playground",
    "type": "s3",
    "parameters": {
      "path": "",
      "bucket": "playground"
    },
    "created_at": "2022-05-10T10:29:12.754824+00:00"
  }
}

Request

DELETE /v1-beta1/storage/storages/1 HTTP/1.1
Host: api.claid.ai
Authorization: Bearer {YOUR_API_KEY}
curl -X DELETE --location "https://api.claid.ai/v1-beta1/storage/storages/1" --http1.1 \
    -H "Host: api.claid.ai" \
    -H "Authorization: Bearer {YOUR_API_KEY}"

Request

PATCH /v1-beta1/storage/storages/1
Host: api.claid.ai
Authorization: Bearer {YOUR_API_KEY}
Content-Type: application/json

{
  "name": "s3-playground",
  "type": "s3",
  "parameters": {
    "bucket": "playground",
    "credentials": {
      "access_key": "AKIAXXXXXXX",
      "secret_access_key": "YourSecretAccessKey"
    }
  }
}
curl -X PATCH --location "https://api.claid.ai/v1-beta1/storage/storages/1" \
    -H "Host: api.claid.ai" \
    -H "Authorization: Bearer {YOUR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d "{
          \"name\": \"s3-playground\",
          \"type\": \"s3\",
          \"parameters\": {
            \"bucket\": \"playground\",
            \"credentials\": {
              \"access_key\": \"AKIAXXXXXXX\",
              \"secret_access_key\": \"YourSecretAccessKey\"
            }
          }
        }"

Response body

{
  "data": {
    "id": 1,
    "name": "s3-playground",
    "type": "s3",
    "parameters": {
      "path": "",
      "bucket": "playground"
    },
    "created_at": "2022-05-10T10:29:12.754824+00:00"
  }
}

parameters supported by the : #todo

parameters supported by the :

GCS storage
Web Folder storage

List Storage Types

get

Retrieves a list of storage types supported by Claid.

Authorizations
Responses
200
List of storage types.
application/json
401
Authorization is required.
application/json
403
Not enough permissions.
application/json
get
GET /v1-beta1/storage/storage-types HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": [
    "web_folder",
    "s3",
    "gcs"
  ]
}

List Storages

get

Retrieves a list of storages connected to your Claid account, as well as their id, name, type, and parameters.

Authorizations
Responses
200
Successful Response
application/json
401
Authorization is required.
application/json
403
Not enough permissions.
application/json
get
GET /v1-beta1/storage/storages HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": [
    {
      "id": 1,
      "name": "text",
      "type": "web_folder",
      "parameters": {
        "path": "",
        "bucket": "text"
      },
      "created_at": "2025-05-28T20:31:03.449Z"
    }
  ]
}

Get Storage

get

Retrieves information about particular storage, including its id, name, type, and parameters.

Authorizations
Path parameters
storage_idintegerRequired
Responses
200
Successful Response
application/json
401
Authorization is required.
application/json
403
Not enough permissions.
application/json
404
Storage not found.
application/json
422
Unprocessable Entity.
application/json
get
GET /v1-beta1/storage/storages/{storage_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": {
    "id": 1,
    "name": "text",
    "type": "web_folder",
    "parameters": {
      "path": "",
      "bucket": "text",
      "credentials": {
        "access_key": "text"
      }
    },
    "created_at": "2025-05-28T20:31:03.449Z"
  }
}

Delete Storage

delete

Disconnects storage from Claid. Note: It doesn't delete your bucket on your cloud platform.

Authorizations
Path parameters
storage_idintegerRequired
Responses
200
Successful Response
application/json
401
Authorization is required.
application/json
403
Not enough permissions.
application/json
404
Storage not found.
application/json
422
Unprocessable Entity.
application/json
delete
DELETE /v1-beta1/storage/storages/{storage_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": null
}
  • Get Storage types
  • GETList Storage Types
  • Get Connected Storages
  • GETList Storages
  • Create a new Claid Storage
  • POSTCreate Storage
  • Describe storage by id
  • GETGet Storage
  • DELETEDelete Storage
  • PATCHPatch Storage

Create Storage

post

Connects storage to Claid. You can connect your AWS S3 or GCP bucket, or your own web folder.

Authorizations
Body
namestring · max: 50Required

The name of storage in Claid. Note: it doesn't have to be the same as a global name of a bucket.

typestring · enumRequired

An enumeration.

Possible values:
parametersany ofRequired

Global parameters of storage (as opposed to Claid's internal properties, such as name and type)

or
or
Responses
200
Successful Response
application/json
401
Authorization is required.
application/json
403
Not enough permissions.
application/json
422
Unprocessable Entity.
application/json
post
POST /v1-beta1/storage/storages HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "name": "text",
  "type": "web_folder",
  "parameters": {
    "path": "",
    "bucket": "text",
    "credentials": {
      "access_key": "text",
      "secret_access_key": "text"
    }
  }
}
{
  "data": {
    "id": 1,
    "name": "text",
    "type": "web_folder",
    "parameters": {
      "path": "",
      "bucket": "text",
      "credentials": {
        "access_key": "text"
      }
    },
    "created_at": "2025-05-28T20:31:03.449Z"
  }
}

Patch Storage

patch

Changes storage name, type, and/or parameters.

Authorizations
Path parameters
storage_idintegerRequired
Body
namestring · max: 50Optional
typestring · enumOptional

An enumeration.

Possible values:
parametersany ofOptional
or
or
Responses
200
Successful Response
application/json
401
Authorization is required.
application/json
403
Not enough permissions.
application/json
404
Storage not found.
application/json
422
Unprocessable Entity.
application/json
patch
PATCH /v1-beta1/storage/storages/{storage_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 143

{
  "name": "text",
  "type": "web_folder",
  "parameters": {
    "path": "text",
    "bucket": "text",
    "credentials": {
      "access_key": "text",
      "secret_access_key": "text"
    }
  }
}
{
  "data": {
    "id": 1,
    "name": "text",
    "type": "web_folder",
    "parameters": {
      "path": "",
      "bucket": "text",
      "credentials": {
        "access_key": "text"
      }
    },
    "created_at": "2025-05-28T20:31:03.449Z"
  }
}