> ## 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.

# Read one fleet event

> Returns a single event with its request body and the agent's full answer. The list read beside this one omits both bodies: it returns up to two hundred rows and would carry every payload to render a table. Read the body here, for the one event you are expanding. An event that does not exist and an event belonging to another workspace both answer 404. The two are deliberately indistinguishable. The read is scoped inside its own query, so no caller can probe for events outside its own workspace. 



## OpenAPI

````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json get /v1/workspaces/{workspace_id}/fleets/{fleet_id}/events/{event_id}
openapi: 3.1.0
info:
  title: agentsfleet Control Plane 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/workspaces/{workspace_id}/fleets/{fleet_id}/events/{event_id}:
    get:
      tags:
        - Fleets
      summary: Read one fleet event
      description: >-
        Returns a single event with its request body and the agent's full
        answer. The list read beside this one omits both bodies: it returns up
        to two hundred rows and would carry every payload to render a table.
        Read the body here, for the one event you are expanding. An event that
        does not exist and an event belonging to another workspace both answer
        404. The two are deliberately indistinguishable. The read is scoped
        inside its own query, so no caller can probe for events outside its own
        workspace. 
      operationId: get_fleet_event
      parameters:
        - name: workspace_id
          in: path
          description: '`UUIDv7` of the workspace.'
          required: true
          schema:
            type: string
        - name: fleet_id
          in: path
          description: '`UUIDv7` of the fleet.'
          required: true
          schema:
            type: string
        - name: event_id
          in: path
          description: '`UUIDv7` of the event.'
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventDetail'
        '400':
          description: The request could not be read
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '401':
          description: No credential, or one this route does not accept
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '403':
          description: The credential is good and lacks the capability this route requires
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '404':
          description: No such resource, or none this caller may see
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '429':
          description: The instance is at its ceiling
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '500':
          description: The daemon failed to answer
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '503':
          description: A dependency this route needs is unreachable
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
      security:
        - BearerAuth: []
components:
  schemas:
    EventDetail:
      type: object
      description: One event as the expanded view renders it — bodies included.
      required:
        - fleet_id
        - event_id
        - workspace_id
        - actor
        - event_type
        - status
        - request_json
        - created_at
        - updated_at
      properties:
        actor:
          type: string
          description: Who or what produced the event.
        checkpoint_id:
          type:
            - string
            - 'null'
          description: The session checkpoint this run wrote, when it wrote one.
        cost_nanos:
          type:
            - integer
            - 'null'
          format: int64
          description: What this event actually cost, summed over its telemetry rows.
        created_at:
          type: integer
          format: int64
          description: Epoch milliseconds the row was created.
        event_id:
          type: string
          description: >-
            The canonical event identifier — the stream entry id that produced
            it.
        event_type:
          type: string
          description: How the event entered the system, as stored.
        failure_detail:
          type:
            - string
            - 'null'
          description: The operator-readable cause line, absent when none was carried.
        failure_label:
          type:
            - string
            - 'null'
          description: What refused or failed the run, absent on a clean one.
        fleet_id:
          type: string
          description: The fleet this event belongs to.
        request_json:
          type: string
          description: The trigger payload as stored, serialized to text.
        response_text:
          type:
            - string
            - 'null'
          description: |-
            The agent's full answer.

            `null` while a run is in flight, and on a run that failed before
            producing one.
        resumes_event_id:
          type:
            - string
            - 'null'
          description: The event this one continues, set on a continuation.
        status:
          type: string
          description: Where the event's run got to, as stored.
        tokens:
          type:
            - integer
            - 'null'
          format: int64
          description: Tokens the run spent, absent until a runner reports.
        updated_at:
          type: integer
          format: int64
          description: Epoch milliseconds the row last changed.
        wall_ms:
          type:
            - integer
            - 'null'
          format: int64
          description: Wall milliseconds the run took, absent until a runner reports.
        workspace_id:
          type: string
          description: The workspace the fleet belongs to.
    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.'
        missing_secrets:
          type:
            - array
            - 'null'
          items:
            type: string
          description: 'On a 424 only: the credentials this workspace has yet to store.'
        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:
            - integer
            - 'null'
          format: int64
          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.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub
        OAuth

````