GET /v1/uploads/{id}

Read an upload

Permission

A key with chosen permissions needs media.read. A key made with every permission may always call it.

Parameters

• id (path)string · required

  uuid

Response: Upload

200 · 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 "https://api.meetkuro.com/v1/uploads/<id>" \
  -H "Authorization: Bearer $KURO_API_KEY"

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

const kuro = new Kuro(); // reads KURO_API_KEY
await kuro.uploads.get("<id>");

Every operation