GET /v1/subjects/{id}

Read a subject

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: Subject

200 · Someone or something you make again and again. Name it in `subjects` and Kuro brings its face and description.

• object"subject"

• idstring

  uuid

• namestring

• kindstring

  "character", "location", "product", "prop" or "wardrobe". New values may be added.

• descriptionstring | null

• identity_imagesinteger

  How many reference pictures travel with it. Zero: it travels as words alone.

• has_voiceboolean

  Whether a voice is bound to it, for voice-overs.

• tagsstring[]

• preview_urlstring | null

  uri

• created_atstring

  date-time

• app_urlstring

  uri

Example

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

curl "https://api.meetkuro.com/v1/subjects/<id>" \
  -H "Authorization: Bearer $KURO_API_KEY"

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

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

Every operation