> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentsfleet.net/llms.txt > Use this file to discover all available pages before exploring further. # List runner activity > Lists a runner's recorded activity newest first. Requires platform administrator access. Filter by event type or an occurrence-time range in milliseconds. ## OpenAPI ````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json get /v1/fleets/runners/{runner_id}/events openapi: 3.1.0 info: title: agentsfleet API description: API for managing workspaces, fleets, triggers, and runs. contact: name: agentsfleet url: https://agentsfleet.net license: name: MIT identifier: MIT version: 1.0.0 servers: - url: https://api.agentsfleet.net description: Production security: [] paths: /v1/fleets/runners/{runner_id}/events: get: tags: - Fleet summary: List runner activity description: >- Lists a runner's recorded activity newest first. Requires platform administrator access. Filter by event type or an occurrence-time range in milliseconds. operationId: list_fleet_runner_events parameters: - name: runner_id in: path description: >- Runner identifier (version 7 universally unique identifier, or UUID). required: true schema: type: string - name: starting_after in: query description: Use the previous response's `next_cursor` unchanged. required: false schema: type: string - name: limit in: query description: Rows per page (1-100). required: false schema: type: string - name: event_type in: query description: >- Filter to one runner event type, or a comma-separated set returning the union (multi-value equality). Allowed tags: runner_registered, runner_online, runner_offline, lease_acquired, lease_released, runner_cordoned, runner_draining, runner_drained, runner_revoked. An unrecognised tag or an empty value refuses the whole request. required: false schema: type: string - name: since in: query description: Lower bound on occurred_at, an RFC 3339 instant (inclusive). required: false schema: type: string - name: until in: query description: >- Upper bound on occurred_at, an RFC 3339 instant (inclusive). Must be >= since. required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RunnerEventsResponse' '400': description: The request is invalid content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '401': description: Authentication is missing, invalid, or not accepted by this endpoint content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '403': description: You do not have permission for this action content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '404': description: The resource was not found or is not accessible to you content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '429': description: A request or capacity limit has been reached content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '500': description: An internal server error occurred content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '503': description: A required service is unavailable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' security: - BearerAuth: [] components: schemas: RunnerEventsResponse: type: object description: A page of runner history. required: - items - total properties: items: type: array items: $ref: '#/components/schemas/RunnerEventItem' description: The rows in this page. next_cursor: type: - string - 'null' description: Cursor for the next page, or null at the end. total: type: integer format: int64 description: Total rows matching the query. additionalProperties: false ProblemBody: type: object description: The body every refusal carries, under `application/problem+json`. required: - docs_uri - title - detail - error_code - request_id properties: action_id: type: - string - 'null' description: 'On that 409 only: the action the gate held.' current_state: type: - string - 'null' description: 'On a 409 only: the state that forbade the transition.' detail: type: string description: One sentence on what was refused and why. docs_uri: type: string description: Where the error code is documented. error_code: type: string description: The registry code, stable across releases. etag: type: - string - 'null' description: >- On a 412 only: the resource's current entity tag, to refetch and retry. gate_id: type: - string - 'null' description: 'On an answered approval gate''s 409 only: the gate that was answered.' outcome: type: - string - 'null' description: 'On that 409 only: the answer that stands.' request_id: type: string description: The request this refusal answers, for support. resolved_at: type: - string - 'null' format: date-time description: 'On that 409 only: when the standing answer was given.' resolved_by: type: - string - 'null' description: 'On that 409 only: who gave it.' title: type: string description: A short name for the refusal, safe to show a person. user_message: type: - string - 'null' description: A curated sentence for end users, where the code has one. RunnerEventItem: type: object description: One row of runner history. required: - id - runner_id - event_type - occurred_at - metadata properties: event_type: $ref: '#/components/schemas/RunnerEventType' description: What happened. id: type: string description: The row's identifier. metadata: description: Event-specific detail. Free-form by design. occurred_at: type: string format: date-time description: When. runner_id: type: string description: The runner it describes. additionalProperties: false RunnerEventType: type: string description: Append-only runner history values. enum: - runner_registered - runner_online - runner_offline - lease_acquired - lease_released - runner_cordoned - runner_draining - runner_drained - runner_revoked - runner_token_rotated - runner_policy_assigned securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Send a dashboard session token, an account API key (`agt_t`), or a command-line credential (`afc_`) as a Bearer token. Each endpoint lists accepted credential types. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.