Skip to content
Swivver logoSWIVVER
API / Schema Preview

Preview the Swivve Object schema

Even before full API release, the schema clarifies how Swivver packages inspectable media for retrieval, citation, and correction tracking.

Sample response

Static preview of object structure

Swivve Object

Representative response payload for evaluation and integration planning.

{
  "story_id": "swv_0193a",
  "headline": "Agency confirms regional transport disruption update",
  "video_url": "https://cdn.swivver.ai/video/swv_0193a",
  "video_access_mode": "licensed_stream",
  "transcript": "...",
  "canonical_article": {
    "url": "https://swivver.ai/story/swv_0193a",
    "language": "en"
  },
  "sources": [
    {
      "type": "official_statement",
      "url": "https://example.gov/statement",
      "trust_tier": "primary"
    }
  ],
  "claims": [
    {
      "id": "c1",
      "text": "Service will resume at 18:00 UTC",
      "status": "developing"
    }
  ],
  "status_label": "Developing",
  "correction_events": [
    {
      "timestamp": "2026-03-10T09:05:00Z",
      "reason": "added source citation",
      "author": "editor_desk"
    }
  ],
  "origin_label": "AI-assisted",
  "author_profile": "https://swivver.ai/profiles/ana-cho",
  "author_type": "Verified journalist",
  "rights_scope": {
    "inference": true,
    "embeddings": true,
    "training": false,
    "redistribution": false
  },
  "updated_at": "2026-03-10T09:07:00Z"
}

Integration notes

Designed for answer engines, monitoring copilots, and newsroom assistants.

  • Story state is explicit through status_label and correction_events.
  • Rights scope is attached at object level, not hidden in generic terms.
  • Sources and claims stay linked for citation-aware retrieval.
  • Origin and author type remain visible for accountability and trust scoring.