Assets (Media Library)

The Assets API is your board’s media library. Uploaded files are stored on Kardow and served from cdn.kardow.com, so you always get a stable, public URL to embed in pages, blog posts, or anywhere else. Raw storage URLs are never exposed.

Authenticate with your API key in the x-api-key header. Create keys under Settings > API.

List assets

GET https://api.kardow.com/assets

string

Filter by image, video, or file.

string

Match against the asset title.

number

default:"1"

Page number.

number

default:"20"

Records per page, up to 100.

cURL

curl --url "https://api.kardow.com/assets?type=image&search=cover" \
  --header "x-api-key: your-api-key-here"

Each asset returns id, type, provider, url (cdn.kardow.com), thumbnail_url, title, visibility, metadata, created_at, and updated_at.

Upload an asset

Two ways to add an image. The first (import from a URL) is the easiest for automations and AI: hand Kardow any image URL and it downloads, stores, and returns a hosted link.

Import from a URL

POST https://api.kardow.com/assets
Content-Type: application/json

string

required

URL of the image to import into your library.

string

Optional label.

cURL

curl --request POST \
  --url "https://api.kardow.com/assets" \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{ "source_url": "https://example.com/photo.jpg", "title": "Blog cover" }'

Upload a file directly

Send multipart/form-data with a file field.

cURL

curl --request POST \
  --url "https://api.kardow.com/assets" \
  --header "x-api-key: your-api-key-here" \
  --form "file=@./cover.png" \
  --form "title=Blog cover"

Both return the created asset:

{
  "data": {
    "id": "9b2c...",
    "type": "image",
    "url": "https://cdn.kardow.com/abc123/storage/v1/object/public/org-assets/42/library/9b2c.png",
    "title": "Blog cover",
    "visibility": "public",
    "created_at": "2026-07-11T10:00:00.000Z"
  }
}

Use data.url as a page or blog cover_image, or embed it in page content as <img src="...">.

Max upload size is 15MB. Supported image types: JPEG, PNG, GIF, WebP, AVIF, SVG.

Getting Started

Analytics

Jobs

Applications

Content

Members

Users

Webhooks

Secrets

CMS

Assets (Media Library)

List assets

Upload an asset

Import from a URL

Upload a file directly

​List assets

​Upload an asset

​Import from a URL

​Upload a file directly

List assets

Upload an asset

Import from a URL

Upload a file directly