> ## 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. # Get Event By Id > One event by its id, whichever stream holds it: what a forward or a cause points at. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/workspaces/{workspace}/streams/events/{event_id} 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/{event_id}: get: tags: - v1 - protected - streams summary: Get Event By Id description: >- One event by its id, whichever stream holds it: what a forward or a cause points at. operationId: get_event_by_id_v1_streams_events__event_id__get parameters: - in: path name: event_id required: true schema: format: uuid title: Event Id type: string - 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 responses: '200': content: application/json: schema: $ref: '#/components/schemas/StreamEventDetailResponse' description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: StreamEventDetailResponse: properties: attachments: items: $ref: '#/components/schemas/EventAttachmentResponse' title: Attachments type: array body_url: anyOf: - type: string - type: 'null' description: Download link for data.body_ref; null without one. title: Body Url causation_id: anyOf: - type: string - type: 'null' title: Causation Id correlation_id: anyOf: - type: string - type: 'null' title: Correlation Id data: additionalProperties: true description: '{headers, body, body_ref}: the request as sent.' title: Data type: object depth: title: Depth type: integer event_id: format: uuid title: Event Id type: string handlers: description: >- One per subscription that reacted so far; the rest are still to come. items: $ref: '#/components/schemas/HandlerResponse' title: Handlers type: array key: title: Key type: string kind: title: Kind type: string occurred_at: format: date-time title: Occurred At type: string outcomes: description: >- One per subscription that took the event; empty means nobody listened. items: $ref: '#/components/schemas/OutcomeResponse' title: Outcomes type: array processing: anyOf: - $ref: '#/components/schemas/Processing' - type: 'null' description: What the platform did with it; on the workspace feed. 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 - data - body_url - attachments - outcomes - handlers title: StreamEventDetailResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object EventAttachmentResponse: properties: mime: anyOf: - type: string - type: 'null' title: Mime name: title: Name type: string ref: description: A workspace file path, or the provider's reference (JSON). title: Ref type: string sha256: anyOf: - type: string - type: 'null' title: Sha256 size: anyOf: - type: integer - type: 'null' title: Size url: anyOf: - type: string - type: 'null' description: Download link for a stored file; null for a provider's reference. title: Url required: - name - mime - size - sha256 - ref - url title: EventAttachmentResponse type: object HandlerResponse: description: >- One subscription's reaction to an event, named for the person reading it. properties: derived_event_ids: items: format: uuid type: string title: Derived Event Ids type: array kind: description: trigger, forward, or deleted title: Kind type: string name: description: The trigger's name, or the streams a forward writes to. title: Name type: string reason: anyOf: - type: string - type: 'null' title: Reason subscription_id: format: uuid title: Subscription Id type: string task_id: anyOf: - format: uuid type: string - type: 'null' title: Task Id task_status: anyOf: - type: string - type: 'null' title: Task Status verdict: description: reacted, skipped, error, or batched while it waits in an open batch title: Verdict type: string required: - subscription_id - kind - name - verdict - reason - task_id - task_status - derived_event_ids title: HandlerResponse type: object OutcomeResponse: properties: created_at: format: date-time title: Created At type: string derived_event_ids: description: >- Events a forward wrote into its output streams, in output-stream order. items: format: uuid type: string title: Derived Event Ids type: array event_id: format: uuid title: Event Id type: string reason: anyOf: - type: string - type: 'null' title: Reason score: anyOf: - type: number - type: 'null' title: Score subscription_id: format: uuid title: Subscription Id type: string subscription_kind: title: Subscription Kind type: string task_id: anyOf: - format: uuid type: string - type: 'null' title: Task Id trigger_id: anyOf: - format: uuid type: string - type: 'null' title: Trigger Id verdict: description: reacted, skipped, error, or batched while it waits in an open batch title: Verdict type: string required: - subscription_id - subscription_kind - trigger_id - event_id - verdict - reason - score - task_id - derived_event_ids - created_at title: OutcomeResponse 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 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 ProcessingStatus: enum: - queued - processing - handled - error - no_handlers - skipped title: ProcessingStatus type: string 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.