POST /v1/uploads/import

Import a file from a URL

Permission

A key with chosen permissions needs generation.write. A key made with every permission may always call it. It can spend: send an Idempotency-Key so a retry replays the first answer.

Parameters

• Idempotency-Key (header)string · optional

  Any string up to 255 characters. Send the same value to retry a request without spending twice; a different body under a used key is refused with 409.

  up to 255 characters

Body

• urlstring · required

  A file on a host this server is allowed to fetch from (`MEDIA_IMPORT_ALLOWED_HOSTS`).

  uri

• filenamestring · optional

  up to 220 characters

• mime_typestring · optional

  up to 120 characters

Response: Upload

201 · A file you brought into Kuro.

• object"upload"

• idstring

  uuid

• filenamestring

• typestring

  one of "image", "video", "audio"

• mime_typestring

• bytesinteger

• statusstring

  Only a `verified` upload can be used in a generation.

  one of "pending", "verified", "rejected", "expired"

• urlstring

  A signed link to the file, for about an hour.

  uri

• thumbnail_urlstring | null

  uri

• referenceobject | object

  Pass this where a request takes media.

• created_atstring

  date-time

Example

The required fields only, each a placeholder. Replace them before sending.

curl -X POST "https://api.meetkuro.com/v1/uploads/import" \
  -H "Authorization: Bearer $KURO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<url>"}'

import { Kuro } from "@meetkuro/sdk";

const kuro = new Kuro(); // reads KURO_API_KEY
await kuro.uploads.import({ url: "https://…" });

Every operation