> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # List your agent's events > What happened to your personal agent in the last ninety days, newest first: wakes and what caused them, sleeps, pauses, image updates, MCP servers left out of its configuration, and model calls refused for your balance or its daily cap. It never holds what the agent said or was told. Refused (404 agent_event_not_found) when before is not one of your agent's events. ## OpenAPI ````yaml api-reference/openapi.account.json GET /agent/events openapi: 3.1.0 info: title: Aether Account & Integrations API version: 0.1.0 description: >- Account, billing, and integration-management endpoints used by the Aether web app and CLI. Root-mounted; NOT part of the versioned /v1 contract. servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /agent/events: get: tags: - agent summary: List your agent's events description: >- What happened to your personal agent in the last ninety days, newest first: wakes and what caused them, sleeps, pauses, image updates, MCP servers left out of its configuration, and model calls refused for your balance or its daily cap. It never holds what the agent said or was told. Refused (404 agent_event_not_found) when before is not one of your agent's events. operationId: listAgentEvents parameters: - description: >- The id of the event the page starts after: the last of the previous page. explode: false in: query name: before schema: description: >- The id of the event the page starts after: the last of the previous page. format: uuid type: string - explode: false in: query name: limit schema: default: 50 format: int64 maximum: 200 minimum: 1 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/AgentEvents' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error components: schemas: AgentEvents: additionalProperties: false properties: events: description: Newest first. items: $ref: '#/components/schemas/AgentEvent' type: array window_days: description: How many days back the ledger reaches; older events are not shown. format: int64 type: integer required: - events - window_days type: object ErrorResponse: additionalProperties: false properties: code: type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting type: string error: minLength: 1 type: string required: - error - code type: object AgentEvent: additionalProperties: false properties: cap_day: description: >- The day, in your timezone, whose spend reached the cap; present on daily_cap_reached. pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ type: string id: format: uuid type: string kind: description: >- inference_run_out: a model call was refused because your balance ran out; wake and wake_failed: the agent was woken, or did not come up; suspended and stopped: it went to sleep; suspend_failed: it stayed awake; machine_lost: its machine was gone; paused and pause_failed: it was backed up and paused, or the pause did not happen; bootstrap_refused: a machine presented its spent first-boot token; updated and update_failed: it moved onto a new image, or did not; mcp_server_refused: an MCP server you enabled was left out of its configuration; daily_cap_reached: a model call was refused because the day's spend reached its daily cap. enum: - inference_run_out - wake - wake_failed - suspended - stopped - suspend_failed - machine_lost - paused - pause_failed - bootstrap_refused - updated - update_failed - mcp_server_refused - daily_cap_reached type: string occurred_at: format: date-time type: string refusal: description: Why the MCP server was left out; present on mcp_server_refused. enum: - org_suspended - takes_secret - name_taken - hermes_substitution type: string server_key: description: The MCP server's key; present on mcp_server_refused. type: string wake_cause: description: What woke the agent; present on wake and wake_failed. enum: - operator - followed_update type: string required: - id - kind - occurred_at type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.