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

# List feed runs

> List Clara Feed runs and schedules.



## OpenAPI

````yaml /openapi.json get /v1/feed
openapi: 3.1.0
info:
  title: nOps Public API
  version: 1.0.0
  description: >-
    Programmatic access to nOps cost, budgets, cost allocation, Explorer
    dashboards, AI optimization, MAP manager, business unit economics, contract
    tracker, reports, recommendations, feed, scheduled prompts, and
    notifications. Authenticate with an API key (Bearer token). Available on
    Inform + Operate.
servers:
  - url: https://api.nops.io
    description: Production
security:
  - bearerApiKey: []
tags:
  - name: Recommendations
    description: Cost optimization recommendations.
  - name: Anomalies
    description: AWS cost anomaly detection.
  - name: Explorer
    description: Cost Explorer queries — summary, history, heatmap, and dimensions.
  - name: Budgets
    description: Budgets, planning grids, alerts, and exports.
  - name: Reports
    description: Saved reports — create, update, render, and send.
  - name: Feed
    description: Clara Feed runs and delivery history.
  - name: Scheduled prompts
    description: Scheduled Clara prompts and manual runs.
  - name: Notifications
    description: Schedule and manage notification deliveries.
  - name: Commitments
    description: Commitment inventory (reserved for future use).
  - name: Cost allocation
    description: Cost Allocation showbacks, rules, and spend analytics.
  - name: Explorer dashboards
    description: Explorer dashboard layouts and widgets.
  - name: AI optimization
    description: AI Optimization default dashboard and anomaly insights.
  - name: MAP Manager
    description: AWS Migration Acceleration Program (MAP) project tracking.
  - name: Business unit economics
    description: Business unit economics models, units, and portfolio summaries.
  - name: Contract tracker
    description: Enterprise contract tracking and burndown analytics.
paths:
  /v1/feed:
    get:
      tags:
        - Feed
      summary: List feed runs
      description: List Clara Feed runs and schedules.
      operationId: listFeedRuns
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 200
            description: Maximum items to return (1–200, default 50).
          required: false
          name: limit
          in: query
        - schema:
            type: string
            description: Opaque cursor from a previous response's `pagination.next_cursor`.
          required: false
          name: cursor
          in: query
      responses:
        '200':
          description: List feed runs
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      description: JSON object
                      additionalProperties: true
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - data
                  - pagination
              example:
                data:
                  - id: clxrun01abc
                    scheduledPromptId: clxprompt01xyz
                    status: completed
                    queuedAt: '2026-07-17T12:00:00.000Z'
                    startedAt: '2026-07-17T12:00:00.000Z'
                    finishedAt: '2026-07-17T12:00:00.000Z'
                    title: Weekly EC2 spend summary
                    summary: Spend rose 4% week over week across production accounts.
                    responsePreview:
                      hasChart: true
                      hasTable: false
                      chartCount: 1
                      tableCount: 0
                      previewMarkdown: |-
                        ```chart
                        ...
                        ```
                    runtimeSessionId: sess_abc123
                    errorMessage: null
                    scheduledPrompt:
                      id: clxprompt01xyz
                      name: Weekly EC2 summary
                      scope: private
                      canvasId: clxcanvas01
                      category: FinOps Analyst
                      domain: Compute
                    canContinueInClara: true
                pagination:
                  limit: 50
                  has_more: false
                  next_cursor: null
        '401':
          description: Unauthorized — invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              example:
                error:
                  code: forbidden_scope
                  message: 'API key is missing required scope: budgets:write'
                  request_id: 550e8400-e29b-41d4-a716-446655440000
        '403':
          description: Forbidden — insufficient permissions or entitlement
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              example:
                error:
                  code: forbidden_scope
                  message: 'API key is missing required scope: budgets:write'
                  request_id: 550e8400-e29b-41d4-a716-446655440000
      security:
        - bearerApiKey: []
components:
  schemas:
    Pagination:
      type: object
      properties:
        limit:
          type: integer
          description: Page size used for this response.
        has_more:
          type: boolean
          description: True when more results are available via next_cursor.
        next_cursor:
          type: string
          nullable: true
          description: >-
            Opaque cursor for the next page, or null when there are no more
            results.
      required:
        - limit
        - has_more
        - next_cursor
    PublicApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
          required:
            - code
            - message
            - request_id
      required:
        - error
  securitySchemes:
    bearerApiKey:
      type: http
      scheme: bearer
      description: >-
        API key from Settings → Security → API Keys. Pass as `Authorization:
        Bearer YOUR_API_KEY`.

````