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

# List Find Moments Runs

> Lists runs, newest first, with cursor pagination. Pagination is over runs, never over joined moment rows.



## OpenAPI

````yaml GET /find-moments
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:
    get:
      tags:
        - Find Moments
      summary: List find-moments runs
      description: >-
        Lists runs, newest first, with cursor pagination. Pagination is over
        runs, never over joined moment rows.
      operationId: listFindMoments
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: cursor
          in: query
          description: Opaque cursor from a previous page's next_cursor.
          schema:
            type: string
        - name: status
          in: query
          schema:
            type: string
            enum:
              - pending
              - processing
              - completed
              - failed
              - cancelled
        - name: created_before
          in: query
          schema:
            type: string
            format: date
        - name: created_after
          in: query
          schema:
            type: string
            format: date
        - name: url
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Runs, newest first.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindMomentsList'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    FindMomentsList:
      type: object
      properties:
        runs:
          type: array
          items:
            $ref: '#/components/schemas/FindMoments'
        total:
          type: integer
        next_cursor:
          type: string
          description: Present when more runs exist; pass as the cursor parameter.
      required:
        - runs
        - total
    Error:
      required:
        - error
      type: object
      properties:
        error:
          type: string
    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
    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

````