training

Get Training Sample

get/training/samples/{sample_id}

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/training/samples/{sample_id}
  • Auth
    HTTP bearer

Path parameters

sample_idstring required

Response

Successful Response

idstring uuid required

UUID of the training sample

event_idstring uuid nullable

Drill-back to the live event; null once that event is deleted

source_event_idstring uuid required

Permanent provenance key: the event this sample snapshotted

created_atstring date-time required

When the sample was captured

occurred_atstring date-time required

Motion time (ingestor-reported, falling back to event creation)

evaluated_atstring date-time required

When the disposition was written

ai_incident_typestring nullable

AI incident classification snapshot

ai_severitystring nullable

AI severity snapshot

ai_confidence_bandstring nullable

AI self-reported confidence band snapshot

ai_recommended_actionstring nullable

AI operator-aligned recommendation snapshot; null when the eval carried none

operator_dispositionstring required

Enum member name (stable across display-label renames)

expected_actionstring nullable

The operator disposition crosswalked into the recommendation's 4-class space

is_disagreementboolean nullable

Three-state: true/false when AI and operator are comparable; null when the AI carried no recommendation

actorstring required

Who authored the disposition; only 'operator' rows are ground truth

llm_prompt_versionstring nullable

Prompt version the original eval ran under

llm_modelstring nullable

Model that served the original eval

clip_copy_statusstring required

Whether the clip was durably copied into the training prefix

kvs_stream_namestring nullable

Source camera stream

zonestring nullable

Camera zone label

is_demoboolean required

Sample originated from an owner-uploaded demo clip

rerun_countinteger required

Number of rerun experiments recorded for this sample

capture_versionstring required

Version of the capture logic that wrote this snapshot

original_clip_s3_keystring required

S3 key of the source clip at capture time

training_clip_s3_keystring nullable

S3 key of the durable corpus copy; null when the copy failed

clip_copy_errorstring nullable

Copy failure detail, when any

ai_suggested_dispositionstring nullable

AI suggested disposition snapshot

ai_needs_human_reviewboolean nullable

AI ambiguity flag snapshot

ai_rationalestring nullable

AI rationale snapshot

llm_providerstring nullable

Provider that served the original eval

detection_providerstring nullable

CV detection provider snapshot

detection_model_versionstring nullable

CV detection model version snapshot

pipeline_versionstring nullable

Pipeline version the original eval ran under

roi_config_versionstring nullable

ROI config version snapshot

schema_versionstring nullable

Interpretation schema version snapshot

ai_total_msinteger nullable

Original eval end-to-end latency in milliseconds

ai_cost_usdstring nullable

Original eval inference cost

ai_artifactsobject nullable

{debug, detections, keyframes, roi_hits} snapshotted from the interpretation's child tables

operator_notesstring required

Disposition notes (agent rows carry the agent's rationale)

operator_closeoutobject nullable

Structured close-out snapshot {schema_version, observed, actions[], outcome, outcome_note}; null for rows captured before the feature, false-alarm fast-path rows that submitted none, and agent rows

operator_idstring uuid nullable

Human who dispositioned; null for agent rows

camera_contextstring nullable

The composed SITE/CAMERA context snapshot re-runs replay against

site_timezonestring nullable

Site timezone at capture time

event_local_timestring nullable

Event time in the site's local timezone (ISO)

camera_idstring uuid nullable

Camera the event came from (denormalized)

site_idstring uuid nullable

Site the event came from (denormalized)

parent_idstring uuid nullable

Client the event came from (denormalized)

event_sourcestring nullable

Ingest source label from the event

motion_scorenumber nullable

Ingestor motion score from the event

event_summarystring nullable

Event summary text at capture time

thread_idstring uuid nullable

Cross-camera incident thread, when any

Example response

{
  "operator_disposition": "FALSE_ALARM",
  "actor": "operator",
  "clip_copy_status": "copied",
  "operator_closeout": {
    "actions": [
      "reviewed_clip",
      "viewed_live"
    ],
    "observed": "Two people on foot crossing the west lot",
    "outcome": "subject_left",
    "schema_version": 1
  },
  "reruns": [
    {
      "prompt_profile": "production",
      "status": "succeeded"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.