Assets

Upcoming. Krun One V1 multimodal inputs, including the /v1/assets endpoints, are not yet available on api.krun.ai. This page describes the planned interface. Details can still change before release.

An asset is a file you upload once and then reference by id in a multimodal context.

Method	Path	Description
`POST`	`/v1/assets`	Upload a file.
`GET`	`/v1/assets/{asset_id}`	Get an asset’s metadata.
`DELETE`	`/v1/assets/{asset_id}`	Delete an asset.

All three require an API key. See Authentication.

Upload an asset

POST /v1/assets. The request body is the raw file, not JSON or multipart form data. Set Content-Type to the file’s MIME type.

curl https://api.krun.ai/v1/assets \
  -H "Authorization: Bearer $KRUN_API_KEY" \
  -H "Content-Type: application/pdf" \
  --data-binary @invoice.pdf

from krun import Krun

client = Krun()  # reads KRUN_API_KEY

with open("invoice.pdf", "rb") as f:
    asset = client.assets.create(f.read(), mime_type="application/pdf")

print(asset.id, asset.expires_at)

import { readFile } from "node:fs/promises";
import { Krun } from "@krun-ai/sdk";

const krun = new Krun(); // reads KRUN_API_KEY

const asset = await krun.assets.create(await readFile("invoice.pdf"), { mimeType: "application/pdf" });

Response 201 Created (values are illustrative):

{
  "id": "asset_7fQ2mZkP0aLxAAAAAAAAAAAA",
  "object": "asset",
  "mime_type": "application/pdf",
  "size_bytes": 184233,
  "sha256": "3f8a1c...",
  "created_at": "2026-10-01T12:00:00Z",
  "expires_at": "2026-10-02T12:00:00Z"
}

Field	Description
`id`	Asset id, `asset_` followed by 8 to 64 letters, digits, `_` or `-`. Use it as `asset_id` in a content part.
`object`	Always `"asset"`.
`mime_type`	The file’s MIME type.
`size_bytes`	File size in bytes.
`sha256`	SHA-256 hash of the file.
`created_at`	Upload time, ISO 8601.
`expires_at`	Time after which the asset can no longer be referenced, ISO 8601. 24 hours after upload by default.

The content is checked against Content-Type. An unsupported type, or content that doesn’t match it (a PNG sent as audio/wav), fails with 415 UNSUPPORTED_MIME_TYPE. A file over its size limit fails with 413 ASSET_TOO_LARGE. See supported types and limits.

Get an asset

GET /v1/assets/{asset_id} returns the same object as the upload. It never returns the file’s content.

curl https://api.krun.ai/v1/assets/asset_7fQ2mZkP0aLxAAAAAAAAAAAA \
  -H "Authorization: Bearer $KRUN_API_KEY"

Delete an asset

DELETE /v1/assets/{asset_id} deletes the asset before it expires.

curl -X DELETE https://api.krun.ai/v1/assets/asset_7fQ2mZkP0aLxAAAAAAAAAAAA \
  -H "Authorization: Bearer $KRUN_API_KEY"

{"id": "asset_7fQ2mZkP0aLxAAAAAAAAAAAA", "object": "asset", "deleted": true}

Retention and access

Assets are kept for 24 hours by default, then expire. Referencing an expired asset fails with 410 ASSET_EXPIRED.
Assets are project-scoped: only the project that uploaded an asset can read, use or delete it. Other projects get 403 ASSET_FORBIDDEN.
An unknown id fails with 404 ASSET_NOT_FOUND.

See Multimodal inputs for how media content is handled.

Overview

Concepts

Guides

SDKs

API Reference

Resources

Upload an asset

Get an asset

Delete an asset

Retention and access

​Upload an asset

​Get an asset

​Delete an asset

​Retention and access

Upload an asset

Get an asset

Delete an asset

Retention and access