> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentarea.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Workspace Events > Every event of the workspace's streams the caller may read, newest first. Each carries what the platform did with it (``processing``); bodies are left out, the event's own endpoint has them. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/workspaces/{workspace}/streams/events openapi: 3.1.0 info: description: >- Modular and extensible framework for building AI agents. This API requires JWT Bearer token authentication for most endpoints. Include your JWT token in the Authorization header. Public endpoints include /, /health, /docs, /redoc, and /openapi.json. title: AgentArea API version: 0.1.0 servers: [] security: - bearer: [] paths: /v1/workspaces/{workspace}/streams/events: get: tags: - v1 - protected - streams summary: List Workspace Events description: >- Every event of the workspace's streams the caller may read, newest first. Each carries what the platform did with it (``processing``); bodies are left out, the event's own endpoint has them. operationId: list_workspace_events_v1_streams_events_get parameters: - description: Slug of the workspace the request acts in in: path name: workspace required: true schema: description: Slug of the workspace the request acts in maxLength: 120 pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ title: Workspace type: string - description: Newest first, before this sequence. in: query name: before required: false schema: anyOf: - maximum: 9223372036854776000 minimum: 1 type: integer - type: 'null' description: Newest first, before this sequence. title: Before - in: query name: limit required: false schema: default: 50 maximum: 200 minimum: 1 title: Limit type: integer - in: query name: stream_id required: false schema: anyOf: - format: uuid type: string - type: 'null' title: Stream Id - in: query name: source_type required: false schema: anyOf: - maxLength: 64 type: string - type: 'null' title: Source Type - description: An event kind, or a prefix ending in .* (order.*). in: query name: kind required: false schema: anyOf: - maxLength: 255 type: string - type: 'null' description: An event kind, or a prefix ending in .* (order.*). title: Kind - in: query name: sender required: false schema: anyOf: - maxLength: 512 type: string - type: 'null' title: Sender - in: query name: session_key required: false schema: anyOf: - maxLength: 512 type: string - type: 'null' title: Session Key - description: What the platform did with it. in: query name: result required: false schema: anyOf: - $ref: '#/components/schemas/ProcessingStatus' - type: 'null' description: What the platform did with it. title: Result - description: Received at or after. in: query name: since required: false schema: anyOf: - format: date-time type: string - type: 'null' description: Received at or after. title: Since - description: Received before. in: query name: until required: false schema: anyOf: - format: date-time type: string - type: 'null' description: Received before. title: Until - description: >- False leaves out the platform's own events (source type platform); the first page's counts still include them. in: query name: platform required: false schema: default: true description: >- False leaves out the platform's own events (source type platform); the first page's counts still include them. title: Platform type: boolean responses: '200': content: application/json: schema: $ref: '#/components/schemas/WorkspaceEventPage' description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: ProcessingStatus: enum: - queued - processing - handled - error - no_handlers - skipped title: ProcessingStatus type: string WorkspaceEventPage: properties: events: items: $ref: '#/components/schemas/FeedEventResponse' title: Events type: array facets: anyOf: - $ref: '#/components/schemas/FeedFacetsResponse' - type: 'null' description: On the first page only (no ?before=). next_before: anyOf: - type: integer - type: 'null' description: Pass as ?before= for older events; null at the start. title: Next Before required: - events title: WorkspaceEventPage type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object FeedEventResponse: description: An event's envelope without its body, and what the platform did with it. properties: attachments: description: How many files the event carries. title: Attachments type: integer causation_id: anyOf: - type: string - type: 'null' title: Causation Id correlation_id: anyOf: - type: string - type: 'null' title: Correlation Id depth: title: Depth type: integer event_id: format: uuid title: Event Id type: string key: title: Key type: string kind: title: Kind type: string occurred_at: format: date-time title: Occurred At type: string processing: $ref: '#/components/schemas/Processing' received_at: format: date-time title: Received At type: string sender: anyOf: - type: string - type: 'null' title: Sender sequence: title: Sequence type: integer session_key: anyOf: - type: string - type: 'null' title: Session Key source_id: anyOf: - format: uuid type: string - type: 'null' title: Source Id source_type: anyOf: - type: string - type: 'null' title: Source Type stream_id: format: uuid title: Stream Id type: string v: default: 1 title: V type: integer required: - sequence - event_id - stream_id - source_id - source_type - kind - key - session_key - sender - received_at - occurred_at - depth - correlation_id - causation_id - attachments - processing title: FeedEventResponse type: object FeedFacetsResponse: properties: capped: default: false description: >- Under a filter other than stream and source type the counts stop after the first 1000 matching events; true when more match, so each count is a lower bound. title: Capped type: boolean source_types: additionalProperties: type: integer description: Events per source type under the other filters. title: Source Types type: object streams: additionalProperties: type: integer description: Events per stream under the other filters. propertyNames: format: uuid title: Streams type: object required: - streams - source_types title: FeedFacetsResponse type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object Processing: properties: errors: title: Errors type: integer reacted: description: Subscriptions whose reaction is recorded. title: Reacted type: integer skipped: title: Skipped type: integer status: $ref: '#/components/schemas/ProcessingStatus' subscribers: anyOf: - type: integer - type: 'null' description: Subscriptions the router matched; null until it routed the event. title: Subscribers tasks: items: $ref: '#/components/schemas/ProcessingTask' title: Tasks type: array required: - status - subscribers - reacted - skipped - errors title: Processing type: object ProcessingTask: properties: id: format: uuid title: Id type: string status: title: Status type: string required: - id - status title: ProcessingTask type: object securitySchemes: bearer: bearerFormat: JWT description: JWT Bearer token for authentication scheme: bearer type: http HTTPBearer: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.