Get Find Moments Run

Returns the run; when completed, includes moments and findings shaped by the read parameters. Selection never destroys accepted results: total_moments is always the full accepted count.

GET /find-moments/{job_id}

Get a find-moments run

cURL

curl --request GET \
  --url https://api.cloudglue.dev/v1/find-moments/{job_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "created_at": 123,
  "url": "<string>",
  "find_moments_config": {
    "criterion": {
      "name": "<string>",
      "instructions": "<string>",
      "moment_schema": {},
      "finding_schema": {},
      "anchors": {},
      "scoring": {
        "key": "<string>",
        "min": 123,
        "max": 123,
        "higher_is_better": true,
        "description": "<string>"
      }
    },
    "criterion_hash": "<string>",
    "describe_job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "signals_required": [
      "<string>"
    ],
    "boundary_policy": "sentence",
    "speaker_filter": {},
    "min_duration_seconds": 123,
    "max_duration_seconds": 123,
    "cache_policy": "reuse",
    "engine_version": 123
  },
  "moments": [
    {
      "moment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "start_time": 123,
      "end_time": 123,
      "title": "<string>",
      "reason": "<string>",
      "rank_score": 0.5,
      "anchors": {},
      "speakers": [
        "<string>"
      ],
      "criterion_score": {
        "key": "<string>",
        "value": 123,
        "min": 123,
        "max": 123
      },
      "properties": {},
      "evidence": {
        "signals": [
          "<string>"
        ]
      }
    }
  ],
  "findings": [
    {
      "finding_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "absence",
      "properties": {}
    }
  ],
  "total_moments": 123,
  "error": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

job_id · string<uuid> · required

Query Parameters

limit · integer

Top-k read: return only the k best moments by the active sort. total_moments is unaffected.

Required range: x >= 1

min_score · number

Only moments whose criterion score is at least this value.

sort · enum<string> · default: rank_score

Available options: rank_score, start_time

Response

200

application/json

The run; when completed, includes moments and findings.

job_id · string<uuid> · required

status · enum<string> · required

Available options: pending, processing, completed, failed, cancelled

created_at · integer · required

Unix timestamp in milliseconds when the run was created

url · string · required

find_moments_config · object

Echo of the request as the run resolved it, plus criterion_hash, the resolved describe_job_id, and the engine version. Defaults the request omitted are filled in here.

Show child attributes

moments · object[]

Show child attributes

findings · object[]

Show child attributes

total_moments · integer

Full accepted count, independent of the limit read parameter.

error · string

Curated failure message, present on failed runs.