> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudglue.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml GET /find-moments/{job_id}
openapi: 3.0.0
info:
  title: Cloudglue API
  description: API for Cloudglue
  license:
    name: Apache License 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: 0.7.31
servers:
  - url: https://api.cloudglue.dev/v1
security:
  - bearerAuth: []
paths:
  /find-moments/{job_id}:
    get:
      tags:
        - Find Moments
      summary: Get a find-moments run
      description: >-
        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.
      operationId: getFindMoments
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          description: >-
            Top-k read: return only the k best moments by the active sort.
            total_moments is unaffected.
          schema:
            type: integer
            minimum: 1
        - name: min_score
          in: query
          description: Only moments whose criterion score is at least this value.
          schema:
            type: number
        - name: sort
          in: query
          schema:
            type: string
            enum:
              - rank_score
              - start_time
            default: rank_score
      responses:
        '200':
          description: The run; when completed, includes moments and findings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindMoments'
        '404':
          description: Run not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    FindMoments:
      type: object
      properties:
        job_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
            - cancelled
        created_at:
          type: integer
          description: Unix timestamp in milliseconds when the run was created
        url:
          type: string
        find_moments_config:
          type: object
          description: >-
            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.
          properties:
            criterion:
              $ref: '#/components/schemas/MomentCriterion'
            criterion_hash:
              type: string
              description: >-
                Stable hash of the snapshotted criterion; identical criteria
                share a hash.
            describe_job_id:
              type: string
              format: uuid
              description: >-
                The describe the run actually used, whether reused, pinned, or
                created internally.
            signals_required:
              type: array
              items:
                type: string
            boundary_policy:
              type: string
              enum:
                - sentence
                - tight
                - loose
            speaker_filter:
              type: object
              description: Speaker restriction, present when the request set one.
            min_duration_seconds:
              type: number
            max_duration_seconds:
              type: number
            cache_policy:
              type: string
              enum:
                - reuse
                - refresh
            engine_version:
              type: integer
              description: Version of the moment-discovery engine that produced the run.
        moments:
          type: array
          items:
            $ref: '#/components/schemas/Moment'
        findings:
          type: array
          items:
            $ref: '#/components/schemas/MomentFinding'
        total_moments:
          type: integer
          description: Full accepted count, independent of the limit read parameter.
        error:
          type: string
          description: Curated failure message, present on failed runs.
      required:
        - job_id
        - status
        - created_at
        - url
    Error:
      required:
        - error
      type: object
      properties:
        error:
          type: string
    MomentCriterion:
      type: object
      description: >-
        An inline criterion: rubric instructions plus typed output declarations.
        Snapshotted and hashed onto the run.
      properties:
        name:
          type: string
          pattern: ^[a-z][a-z0-9_]*$
          maxLength: 64
        instructions:
          type: string
          minLength: 1
          description: The complete rubric, including any seed lists and worked examples.
        moment_schema:
          $ref: '#/components/schemas/MomentSchemaDefinition'
        finding_schema:
          $ref: '#/components/schemas/MomentSchemaDefinition'
        anchors:
          type: object
          description: >-
            Named intra-moment timestamps. A non-required anchor that does not
            exist is omitted from the moment - never null.
          additionalProperties:
            type: object
            properties:
              required:
                type: boolean
              description:
                type: string
        scoring:
          type: object
          description: >-
            The rubric's single canonical score: what rank-ordered reads sort by
            and what min_score filters on. Exactly one scoring key per
            criterion.
          properties:
            key:
              type: string
            min:
              type: number
            max:
              type: number
            higher_is_better:
              type: boolean
            description:
              type: string
          required:
            - key
            - min
            - max
      required:
        - name
        - instructions
    Moment:
      type: object
      properties:
        moment_id:
          type: string
          format: uuid
        start_time:
          type: number
          description: Seconds from source start.
        end_time:
          type: number
        anchors:
          type: object
          additionalProperties:
            type: number
          description: >-
            Declared anchors only; an anchor that was not found is absent, never
            null.
        title:
          type: string
        reason:
          type: string
        speakers:
          type: array
          items:
            type: string
        criterion_score:
          $ref: '#/components/schemas/CriterionScore'
        rank_score:
          type: number
          minimum: 0
          maximum: 1
          description: Normalized ordering within the run; what the default sort uses.
        properties:
          type: object
          description: Validates against the criterion's moment_schema.
        evidence:
          type: object
          properties:
            signals:
              type: array
              items:
                type: string
      required:
        - moment_id
        - start_time
        - end_time
        - title
        - reason
        - rank_score
    MomentFinding:
      type: object
      description: >-
        A non-temporal finding, produced whenever the criterion declares a
        finding_schema.
      properties:
        finding_id:
          type: string
          format: uuid
        kind:
          type: string
          enum:
            - absence
            - observation
        properties:
          type: object
          description: Validates against the criterion's finding_schema.
      required:
        - finding_id
        - kind
        - properties
    MomentSchemaDefinition:
      type: object
      description: >-
        A validated JSON Schema subset (the moment schema dialect): a root
        object of string/number/integer/boolean/array-of-those fields, optional
        enums, one nesting level, per-field descriptions. Rejected shapes get a
        field-addressable 400 with a stable code.
    CriterionScore:
      type: object
      description: The rubric's judgment on its own declared scale.
      properties:
        key:
          type: string
        value:
          type: number
        min:
          type: number
        max:
          type: number
      required:
        - key
        - value
        - min
        - max
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````