> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tester.army/llms.txt
> Use this file to discover all available pages before exploring further.

# Get run agent transcript

> Retrieve the full agent transcript for a run: assistant reasoning, tool calls, and tool outputs in execution order. Use this to understand exactly what the agent did and why a step failed. Credential-bearing tool parts are redacted.



## OpenAPI

````yaml /openapi.json get /v1/runs/{id}/messages
openapi: 3.0.0
info:
  title: TestArmy API
  version: 1.0.0
  description: >-
    AI-powered browser automation API for QA testing. Automate web testing
    workflows using natural language prompts.
servers:
  - url: https://tester.army/api
    description: Production API server
security: []
paths:
  /v1/runs/{id}/messages:
    get:
      tags:
        - Test Runs
      summary: Get run agent transcript
      description: >-
        Retrieve the full agent transcript for a run: assistant reasoning, tool
        calls, and tool outputs in execution order. Use this to understand
        exactly what the agent did and why a step failed. Credential-bearing
        tool parts are redacted.
      parameters:
        - schema:
            type: string
            format: uuid
            description: Test run ID
          required: true
          description: Test run ID
          name: id
          in: path
      responses:
        '200':
          description: Agent transcript
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunMessagesResponse'
        '400':
          description: Bad Request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error code or type
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - message
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error code or type
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - message
        '404':
          description: Run not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error code or type
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - message
        '429':
          description: Too Many Requests - Usage limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error code or type
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - message
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error code or type
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - message
        '504':
          description: Gateway Timeout - Test execution exceeded time limit
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error code or type
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - message
      security:
        - bearerAuth: []
components:
  schemas:
    RunMessagesResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            $ref: '#/components/schemas/RunMessage'
          description: Full agent transcript ordered by creation time
      required:
        - messages
    RunMessage:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Message ID
        role:
          type: string
          enum:
            - user
            - assistant
          description: Message author
        parts:
          type: array
          items:
            anyOf:
              - $ref: '#/components/schemas/RunMessageTextPart'
              - $ref: '#/components/schemas/RunMessageToolPart'
          description: >-
            Ordered transcript parts: `text`/`reasoning` entries carry what the
            agent said, `tool` entries carry each tool call with its input and
            output.
        createdAt:
          type: string
          format: date-time
          description: When the message was recorded
      required:
        - id
        - role
        - parts
        - createdAt
    RunMessageTextPart:
      type: object
      properties:
        type:
          type: string
          enum:
            - text
            - reasoning
          description: What the agent said or reasoned
        text:
          type: string
          description: Agent text
      required:
        - type
        - text
    RunMessageToolPart:
      type: object
      properties:
        type:
          type: string
          enum:
            - tool
        toolName:
          type: string
          description: Tool the agent called (e.g. ui_navigate, ui_click)
        status:
          type: string
          enum:
            - completed
            - error
            - pending
          description: Tool call outcome; absent on redacted calls
        summary:
          type: string
          description: >-
            One-line human-readable description of what the tool call did; read
            these in order to follow the run without parsing raw payloads
        input:
          nullable: true
          description: Tool call input
        output:
          nullable: true
          description: Tool call output when the call completed
        errorText:
          type: string
          description: Failure description when the call errored
        redacted:
          type: boolean
          description: True when a credential-bearing tool call was redacted
      required:
        - type
        - toolName
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key authentication using Bearer token format

````