KIkinetk

Poll an async job — status + final result

Changed on

Returns the job's current state. All states (queued, running, succeeded, failed) return 200; 404 for an unknown jobId, 410 once the result has expired (~24h after completion).

On succeeded, result usually carries the per-kind payload inline. When a result is too large to return inline, result is omitted and the response instead carries resultStorage: "s3" plus a short-lived presigned resultUrl (with resultBytes and resultExpiresAt) — fetch that URL directly to download the full payload, and re-poll for a fresh URL if it expires. Recommended polling cadence: every 2–5 seconds. Runtime depends on the job kind and result breadth; broad stats jobs run in the shared 15-minute worker budget and may take longer than the synchronous API request budget.

get/intelligence/jobs/{id}

Request

  • Base URL
    https://api.kinetk.ai/graph
  • Auth
    API key in header x-api-key

Path parameters

idstring required

Response

Successful response

completedAtnumber
errorstring
jobIdstring required
kind'insights' | 'patterns' | 'records' | 'stats' required
resultBytesnumber

Size of the stored result in bytes (present alongside resultUrl).

resultExpiresAtstring

ISO-8601 expiry of resultUrl (clamped to the job's own retention).

resultStorage's3'

Set to "s3" when the result was too large to return inline; in that case result is omitted and resultUrl holds a short-lived presigned download URL instead. Fetch the URL directly; re-poll for a fresh one after it expires (see resultExpiresAt).

resultUrlstring

Short-lived presigned GET URL for a large result (present iff resultStorage === "s3").

startedAtnumber
status'failed' | 'queued' | 'running' | 'succeeded' required
submittedAtnumber required

Changes

  • 0.13167795a69e5Revision changes
    • warning

      added the new 90d enum value to the ///// response property for the response status

    • warning

      added the new 90d enum value to the ///// response property for the response status

    • warning

      added the new 90d enum value to the ///// response property for the response status

  • 0.1c9c05c737ac8Revision changes
    • warning

      added the new patterns enum value to the response property for the response status

    • warning

      added the new stats enum value to the response property for the response status

    • info

      added the optional property ///////// to the response with the status

    • info

      added to the response property anyOf list for the response status

    • info

      removed the campaign enum value from the response property for the response status