> ## Documentation Index > Fetch the complete documentation index at: https://www.fluenterp.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List agent runs > Lists API-originated runs in reverse chronological order. List items do not include documents or conversation IDs. OAuth tokens require the runs:read scope. ## OpenAPI ````yaml /api-reference/openapi.yaml get /api/v1/runs openapi: 3.1.0 info: title: Fluent API version: 1.0.0 summary: Run Fluent agents and access connected data. description: | The public Fluent API powers the CLI and customer integrations. Most successful responses wrap their payload in a data property. Errors contain detail and status properties without that envelope. servers: - url: https://www.fluenterp.com description: Production security: - ApiKey: [] - BearerCredential: [] tags: - name: Discovery description: Find the API, its scopes, and its policies without a credential. - name: Agents description: Discover agents and prepare their input files. - name: Runs description: Start and monitor asynchronous agent runs. - name: Documents description: Read, process, and delete documents produced by agents. - name: Connections description: Discover connected systems and read their records. - name: Databases description: Discover queryable databases and schemas. - name: Tables description: Read records from a queryable table. - name: Queries description: Run queries against accessible databases. - name: Utilities description: Search the web and manage conversation resources. - name: MCP x-group: Model Context Protocol description: Connect an external MCP client to an agent's tools. paths: /api/v1/runs: get: tags: - Runs summary: List agent runs description: | Lists API-originated runs in reverse chronological order. List items do not include documents or conversation IDs. OAuth tokens require the runs:read scope. operationId: listRuns parameters: - name: agent_id in: query description: Restrict results to one agent. schema: type: string format: uuid - name: status in: query description: Restrict results to one run status. schema: $ref: '#/components/schemas/RunStatus' - name: limit in: query description: Maximum number of runs to return. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: offset in: query description: Number of matching runs to skip. schema: type: integer minimum: 0 default: 0 responses: '200': description: Paginated run summaries content: application/json: schema: $ref: '#/components/schemas/RunsListEnvelope' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' security: - ApiKey: [] - BearerCredential: [] - OAuth2: - runs:read components: schemas: RunStatus: type: string enum: - queued - running - completed - failed - cancelled RunsListEnvelope: type: object additionalProperties: false required: - data properties: data: $ref: '#/components/schemas/RunsList' RunsList: type: object additionalProperties: false required: - runs - total - offset - limit properties: runs: type: array items: $ref: '#/components/schemas/RunSummary' total: type: integer minimum: 0 offset: type: integer minimum: 0 limit: type: integer minimum: 1 Error: type: object required: - detail properties: detail: type: string description: Human-readable failure detail. status: type: integer description: HTTP status code. additionalProperties: true example: detail: Agent not found status: 404 RunSummary: type: object required: - id - workflow_type - agent_id - agent_name - status - trace_id - error - created_at - started_at - completed_at properties: id: type: string format: uuid workflow_type: type: - string - 'null' agent_id: type: string format: uuid agent_name: type: - string - 'null' status: $ref: '#/components/schemas/RunStatus' trace_id: type: - string - 'null' error: type: - string - 'null' created_at: type: string format: date-time started_at: type: - string - 'null' format: date-time completed_at: type: - string - 'null' format: date-time responses: BadRequest: description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Missing, invalid, expired, or unsupported credential content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: The credential lacks access or a required scope content: application/json: schema: $ref: '#/components/schemas/Error' RateLimited: description: Rate limit exceeded headers: RateLimit-Limit: description: Requests allowed in the current window. schema: type: integer RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer Retry-After: description: Seconds to wait before retrying. schema: type: integer x-ratelimit-limit: description: Legacy alias of RateLimit-Limit. schema: type: integer x-ratelimit-remaining: description: Legacy alias of RateLimit-Remaining. schema: type: integer x-ratelimit-reset: description: | Unix timestamp (seconds) at which the current window resets. Unlike RateLimit-Reset, which is a delta. schema: type: string content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key description: A Fluent API key beginning with fl-. BearerCredential: type: http scheme: bearer bearerFormat: Fluent API key or OAuth access token description: | A Fluent API key beginning with fl-, or an OAuth access token beginning with flpt_ on operations that support OAuth. OAuth2: type: oauth2 description: | A Fluent OAuth access token beginning with flpt_, sent as a bearer credential. Tokens are granted only the scopes they request, and each operation below lists the scopes it requires. flows: authorizationCode: authorizationUrl: https://www.fluenterp.com/oauth/authorize tokenUrl: https://www.fluenterp.com/oauth/token refreshUrl: https://www.fluenterp.com/oauth/token scopes: agents:read: List the agents the credential's user can see. runs:read: Read agent runs and the documents they produce. runs:write: >- Upload files, create runs, process documents, and delete documents. ````