---
title: "Poll an async job — status + final result"
method: GET
path: "/intelligence/jobs/{id}"
---

# Poll an async job — status + final result

`GET /intelligence/jobs/{id}`

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. Typical
end-to-end run: 5–20 s.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- IJobStatusResponse
  - `completedAt` number
  - `error` string
  - `jobId` string, required
  - `kind` 'insights' | 'records', required
  - `result` union
    - IRecordsJobResult
      - `content` PublicRankedContent[], required
        - `authorReach` number, required
        - `commentCount` number, required
        - `contentType` string, nullable
        - `creatorId` number, nullable
        - `description` string, nullable
        - `engagementDepth` number, required
        - `engagementScore` number, required
        - `enrichment` PublicEnrichment
          - `aestheticStyle` string[], required
          - `attributeConfidence` number, nullable, required
          - `brandProducts` string[], required
          - `coverage` object, required
            - `attributes` boolean, required
            - `novelty` boolean, required
            - `sentiment` boolean, required
          - `emotionMood` string[], required
          - `noveltyScore` number, nullable, required
          - `saturationScore` number, nullable, required
          - `themes` string[], required
          - `tone` string, nullable, required
          - `toneConfidence` number, nullable, required
        - `exampleRankingScore` number, required
        - `followerCount` number, nullable
        - `likeCount` number, required
        - `platform` string, nullable
        - `publishedAt` string, nullable
        - `rawSimilarity` number, required
        - `recencyScore` number, required
        - `relevance` number
        - `rrfScore` number, required
        - `shareCount` number, required
        - `similarity` number, required
        - `subjectMatch` boolean
        - `tags` string[], required
        - `textRerankScore` number, nullable
        - `title` string, nullable
        - `uuid` string, required
        - `viewCount` number, required
      - `generatedAt` string, required
      - `graph` object, required
        - `edges` object[], required
          - `source` string, required
          - `target` string, required
          - `type` 'contains' | 'creator_posted' | 'semantic_similarity' | 'tag_overlap' | 'tagged_with', required
          - `weight` number, required
        - `nodes` object[], required
          - `creatorId` number
          - `id` string, required
          - `label` string, required
          - `score` number
          - `type` 'content' | 'creator' | 'narrative' | 'tag', required
      - `query` string, required
      - `type` 'kinetk.query_intelligence.record.v1', required
      - `window` '30d' | '7d' | 'all', required
    - IInsightsJobResult
      - `attributeLifts` object[], required
        - `lifts` object[], required
          - `avgWith` number, required
          - `avgWithout` number, required
          - `countWith` number, required
          - `countWithout` number, required
          - `liftPct` number, required
          - `tag` string, required
        - `narrativeId` string, required
        - `narrativeLabel` string, required
      - `content` PublicRankedContent[], required
        - `authorReach` number, required
        - `commentCount` number, required
        - `contentType` string, nullable
        - `creatorId` number, nullable
        - `description` string, nullable
        - `engagementDepth` number, required
        - `engagementScore` number, required
        - `enrichment` PublicEnrichment
          - `aestheticStyle` string[], required
          - `attributeConfidence` number, nullable, required
          - `brandProducts` string[], required
          - `coverage` object, required
            - `attributes` boolean, required
            - `novelty` boolean, required
            - `sentiment` boolean, required
          - `emotionMood` string[], required
          - `noveltyScore` number, nullable, required
          - `saturationScore` number, nullable, required
          - `themes` string[], required
          - `tone` string, nullable, required
          - `toneConfidence` number, nullable, required
        - `exampleRankingScore` number, required
        - `followerCount` number, nullable
        - `likeCount` number, required
        - `platform` string, nullable
        - `publishedAt` string, nullable
        - `rawSimilarity` number, required
        - `recencyScore` number, required
        - `relevance` number
        - `rrfScore` number, required
        - `shareCount` number, required
        - `similarity` number, required
        - `subjectMatch` boolean
        - `tags` string[], required
        - `textRerankScore` number, nullable
        - `title` string, nullable
        - `uuid` string, required
        - `viewCount` number, required
      - `contentGraph` object, required
        - `edges` object[], required
          - `source` string, required
          - `target` string, required
          - `type` 'contains' | 'creator_posted' | 'semantic_similarity' | 'tag_overlap' | 'tagged_with', required
          - `weight` number, required
        - `nodes` object[], required
          - `creatorId` number
          - `id` string, required
          - `label` string, required
          - `score` number
          - `type` 'content' | 'creator' | 'narrative' | 'tag', required
      - `creatorGraph` object, required
        - `edges` object[], required
          - `source` string, required
          - `target` string, required
          - `type` 'contains' | 'creator_posted' | 'semantic_similarity' | 'tag_overlap' | 'tagged_with', required
          - `weight` number, required
        - `nodes` object[], required
          - `creatorId` number
          - `id` string, required
          - `label` string, required
          - `score` number
          - `type` 'content' | 'creator' | 'narrative' | 'tag', required
      - `creators` object[], required
        - `amplifierScore` number, required
        - `avgFinalScore` number, required
        - `contentCount` number, required
        - `creatorId` number, nullable
        - `followerCount` number, nullable
        - `platform` string, required
        - `totalEngagement` number, required
      - `generatedAt` string, required
      - `graph` object, required
        - `edges` object[], required
          - `source` string, required
          - `target` string, required
          - `type` 'contains' | 'creator_posted' | 'semantic_similarity' | 'tag_overlap' | 'tagged_with', required
          - `weight` number, required
        - `nodes` object[], required
          - `creatorId` number
          - `id` string, required
          - `label` string, required
          - `score` number
          - `type` 'content' | 'creator' | 'narrative' | 'tag', required
      - `insights` string[]
      - `narrativeGraph` object, required
        - `edges` object[], required
          - `source` string, required
          - `target` string, required
          - `type` 'contains' | 'creator_posted' | 'semantic_similarity' | 'tag_overlap' | 'tagged_with', required
          - `weight` number, required
        - `nodes` object[], required
          - `creatorId` number
          - `id` string, required
          - `label` string, required
          - `score` number
          - `type` 'content' | 'creator' | 'narrative' | 'tag', required
      - `narrativeInsights` string[]
      - `narrativeSaturation` object[], required
        - `available` boolean, required
        - `coveredCount` number, required
        - `narrativeId` string, required
        - `narrativeLabel` string, required
        - `saturation` number, nullable, required
        - `saturationCoverage` number, required
      - `narrativeSentiment` object[], required
        - `dominantTone` string, nullable, required
        - `membersWithSentiment` number, required
        - `narrativeId` string, required
        - `narrativeLabel` string, required
        - `netStance` number, nullable, required
        - `stance` object, nullable, required
          - `supportive` number, required
          - `critical` number, required
          - `neutral` number, required
          - `mixed` number, required
        - `stanceAvailable` boolean, required
        - `stanceCoverage` number, required
        - `stanceScored` number, required
        - `toneAvailable` boolean, required
        - `toneCoverage` number, required
      - `narratives` object[], required
        - `contentCount` number, required
        - `contentUuids` string[], required
        - `creatorCount` number, required
        - `id` string, required
        - `label` string, required
        - `persistentLink` union
          - object
            - `acceleration` number, nullable, required
            - `diffusion` number, nullable, required
            - `emergingScore` number, nullable, required
            - `label` string, required
            - `lifecycle` string, nullable, required
            - `matchConfidence` 'high' | 'medium', required
            - `matchScore` number, required
            - `momentumScore` number, nullable, required
            - `narrativeKey` string, required
            - `sentimentLabel` string, nullable, required
            - `sentimentScore` number, nullable, required
            - `sharedTerms` string[], required
            - `status` 'linked', required
            - `trajectoryConfidence` string, nullable, required
            - `velocity` number, nullable, required
          - object
            - `status` 'net_new', required
          - object
            - `reason` 'insufficient_signal' | 'no_persistent_generation', required
            - `status` 'unavailable', required
        - `platformCount` number, required
        - `queryRelevance` number
        - `representativeContent` PublicRankedContent[], required
          - `authorReach` number, required
          - `commentCount` number, required
          - `contentType` string, nullable
          - `creatorId` number, nullable
          - `description` string, nullable
          - `engagementDepth` number, required
          - `engagementScore` number, required
          - `enrichment` PublicEnrichment
            - `aestheticStyle` string[], required
            - `attributeConfidence` number, nullable, required
            - `brandProducts` string[], required
            - `coverage` object, required
              - …
            - `emotionMood` string[], required
            - `noveltyScore` number, nullable, required
            - `saturationScore` number, nullable, required
            - `themes` string[], required
            - `tone` string, nullable, required
            - `toneConfidence` number, nullable, required
          - `exampleRankingScore` number, required
          - `followerCount` number, nullable
          - `likeCount` number, required
          - `platform` string, nullable
          - `publishedAt` string, nullable
          - `rawSimilarity` number, required
          - `recencyScore` number, required
          - `relevance` number
          - `rrfScore` number, required
          - `shareCount` number, required
          - `similarity` number, required
          - `subjectMatch` boolean
          - `tags` string[], required
          - `textRerankScore` number, nullable
          - `title` string, nullable
          - `uuid` string, required
          - `viewCount` number, required
        - `scoreBreakdown` object, required
          - `creatorDiversity` number, required
          - `engagementStrength` number, required
          - `platformSpread` number, required
          - `recencyStrength` number, required
        - `summary` string, required
        - `topTags` string[], required
        - `topThemes` string[], required
        - `totalEngagement` number, required
        - `trendScore` number, required
      - `platformOpportunities` object[], required
        - `avgEngagement` number, required
        - `baselineEngagement` number, required
        - `contentCount` number, required
        - `creatorCount` number, required
        - `dominantPlatform` string, required
        - `engagementPremiumPct` number, required
        - `narrativeId` string, required
        - `narrativeLabel` string, required
        - `opportunity` string, required
        - `opportunityScore` number, required
        - `platformConcentration` number, required
        - `platformDistribution` object, required
      - `query` string, required
      - `tagCombinations` object[], required
        - `avgEngagementA` number, required
        - `avgEngagementB` number, required
        - `avgEngagementTogether` number, required
        - `combination` string, required
        - `combinationLiftPct` number, required
        - `cooccurrence` number, required
        - `tagA` string, required
        - `tagB` string, required
      - `tagGraph` object, required
        - `edges` object[], required
          - `source` string, required
          - `target` string, required
          - `type` 'contains' | 'creator_posted' | 'semantic_similarity' | 'tag_overlap' | 'tagged_with', required
          - `weight` number, required
        - `nodes` object[], required
          - `creatorId` number
          - `id` string, required
          - `label` string, required
          - `score` number
          - `type` 'content' | 'creator' | 'narrative' | 'tag', required
      - `tagInsights` string[]
      - `tagNarrativeMap` object[], required
        - `avgEngagement` number, required
        - `dominantNarrativeId` string, required
        - `dominantNarrativeLabel` string, required
        - `engagementPremiumPct` number, required
        - `exclusivity` number, required
        - `frequency` number, required
        - `platformCount` number, required
        - `role` 'Bridge' | 'Shared' | 'Signature', required
        - `tag` string, required
      - `tagSignals` object[], required
        - `avgEngagement` number, required
        - `baselineEngagement` number, required
        - `count` number, required
        - `dominantPlatform` string, required
        - `engagementPremiumPct` number, required
        - `opportunityScore` number, required
        - `platformConcentration` number, required
        - `platformDistribution` object, required
        - `saturation` number, nullable, required
        - `saturationCoverage` number, required
        - `tag` string, required
        - `whitespaceScore` number, nullable, required
      - `themeSignals` object, required
        - `available` boolean, required
        - `coverage` number, required
        - `coverageFloor` number, required
        - `coveredCount` number, required
        - `signals` object[], required
          - `avgEngagement` number, required
          - `baselineEngagement` number, required
          - `count` number, required
          - `dominantPlatform` string, required
          - `engagementPremiumPct` number, required
          - `opportunityScore` number, required
          - `platformConcentration` number, required
          - `platformDistribution` object, required
          - `saturation` number, nullable, required
          - `saturationCoverage` number, required
          - `theme` string, required
          - `whitespaceScore` number, nullable, required
      - `topTags` object[], required
        - `avgEngagement` number, required
        - `engagementPremiumPct` number, required
        - `frequency` number, required
        - `momentumScore` number, required
        - `platformCount` number, required
        - `signalClass` string, required
        - `tag` string, required
      - `type` 'kinetk.query_intelligence.insights.v1', required
      - `window` '30d' | '7d' | 'all', required
  - `resultBytes` number — Size of the stored result in bytes (present alongside resultUrl).
  - `resultExpiresAt` string — 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).
  - `resultUrl` string — Short-lived presigned GET URL for a large result (present iff resultStorage === "s3").
  - `startedAt` number
  - `status` 'failed' | 'queued' | 'running' | 'succeeded', required
  - `submittedAt` number, required

## Other responses

- `default` — Error response

---

[API](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api.md) · [All operations](https://skmtc.dev/kinetk/apis/kinetk-graph-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kinetk/kinetk-graph-service-api/revisions/380fcc6f794a/schema)