GET /v1/runs/{id}

Read a run

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

• waitinteger · optional

  Hold the response up to this many seconds until the work settles. 0 answers at once.

  default 0 · min 0 · max 60

Response: Run

200 · One run of a `run` recipe: several steps, several generations.

• object"run"

• idstring

  uuid

• statusstring

  `succeeded`, `failed` and `canceled` are final. `awaiting_approval` and `paused` wait on you in the app (`app_url`). New values may be added.

  one of "queued", "running", "awaiting_approval", "paused", "succeeded", "failed", "canceled"

• errorobject | null

• generationsGeneration[]

  Everything the run has made so far, in order.

• created_atstring

  date-time

• completed_atstring | null

  date-time

• app_urlstring

  uri

Example

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

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

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

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

Every operation