> ## 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. # Read one subagent's transcript > The text a subagent produced and the tools it called, in stream order, named by the tool call in the parent transcript that spawned it. Read-only and capped; `truncated` says the cap was hit. ## OpenAPI ````yaml api-reference/openapi.v1.json GET /tasks/{taskID}/subagents/{toolCallID}/events openapi: 3.1.0 info: title: Aether Public API version: 0.1.0 description: >- The versioned, public Aether REST API. Authenticate with an `aether_` platform API key or a session token. servers: - url: https://api.runaether.dev/v1 security: - bearerAuth: [] paths: /tasks/{taskID}/subagents/{toolCallID}/events: get: tags: - tasks summary: Read one subagent's transcript description: >- The text a subagent produced and the tools it called, in stream order, named by the tool call in the parent transcript that spawned it. Read-only and capped; `truncated` says the cap was hit. operationId: listTaskSubagentEvents parameters: - in: path name: taskID required: true schema: format: uuid pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ type: string - in: path name: toolCallID required: true schema: maxLength: 512 minLength: 1 type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/TaskSubagentEventsResponse' description: OK '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 '503': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Service Unavailable components: schemas: TaskSubagentEventsResponse: additionalProperties: false properties: events: items: discriminator: mapping: text: $ref: '#/components/schemas/TaskSubagentTextEvent' tool_result: $ref: '#/components/schemas/TaskSubagentToolResultEvent' tool_use: $ref: '#/components/schemas/TaskSubagentToolUseEvent' propertyName: kind oneOf: - $ref: '#/components/schemas/TaskSubagentTextEvent' - $ref: '#/components/schemas/TaskSubagentToolUseEvent' - $ref: '#/components/schemas/TaskSubagentToolResultEvent' type: array truncated: type: boolean required: - events - truncated 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 TaskSubagentTextEvent: additionalProperties: false properties: content: minLength: 1 type: string created_at: format: date-time type: string kind: enum: - text type: string message_id: minLength: 1 type: string sequence: format: int64 maximum: 9007199254740991 minimum: 0 type: integer required: - kind - sequence - created_at - message_id - content type: object TaskSubagentToolResultEvent: additionalProperties: false properties: created_at: format: date-time type: string error: type: string kind: enum: - tool_result type: string result: type: string sequence: format: int64 maximum: 9007199254740991 minimum: 0 type: integer status: enum: - output-available - output-error - output-denied - approval-responded type: string tool_id: minLength: 1 type: string required: - kind - sequence - created_at - tool_id - status type: object TaskSubagentToolUseEvent: additionalProperties: false properties: created_at: format: date-time type: string kind: enum: - tool_use type: string sequence: format: int64 maximum: 9007199254740991 minimum: 0 type: integer tool: $ref: '#/components/schemas/TaskTimelineTool' required: - kind - sequence - created_at - tool 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 TaskTimelineTool: additionalProperties: false properties: display: $ref: '#/components/schemas/ToolDisplay' durationMs: format: int64 maximum: 9007199254740991 minimum: 0 type: integer error: type: string exitCode: format: int32 maximum: 2147483647 minimum: -2147483648 type: integer id: minLength: 1 type: string input: additionalProperties: true properties: {} type: object itemType: enum: - user_message - assistant_message - reasoning - plan - command_execution - file_change - file_read - mcp_tool_call - dynamic_tool_call - collab_agent_tool_call - web_search - web_fetch - image_view - task_tracking - subagent_invocation - review_entered - review_exited - context_compaction - error - unknown type: string name: minLength: 1 type: string provider: enum: - codex - claude-code - opencode - cursor type: string result: type: string status: enum: - input-streaming - input-available - output-available - output-error - output-denied - approval-responded - approval-requested type: string required: - id - name - input - status - display type: object ToolDisplay: additionalProperties: false properties: blocks: items: $ref: '#/components/schemas/DisplayBlock' type: array label: minLength: 1 type: string primary: minLength: 1 type: string secondary: minLength: 1 type: string required: - label type: object DisplayBlock: discriminator: mapping: badge: $ref: '#/components/schemas/BadgeDisplayBlock' code: $ref: '#/components/schemas/CodeDisplayBlock' file_tree: $ref: '#/components/schemas/FileTreeDisplayBlock' image: $ref: '#/components/schemas/ImageDisplayBlock' key_value: $ref: '#/components/schemas/KeyValueDisplayBlock' link: $ref: '#/components/schemas/LinkDisplayBlock' markdown: $ref: '#/components/schemas/MarkdownDisplayBlock' note: $ref: '#/components/schemas/NoteDisplayBlock' search_results: $ref: '#/components/schemas/SearchResultsDisplayBlock' terminal: $ref: '#/components/schemas/TerminalDisplayBlock' todo_list: $ref: '#/components/schemas/TodoListDisplayBlock' video: $ref: '#/components/schemas/VideoDisplayBlock' propertyName: type oneOf: - $ref: '#/components/schemas/TerminalDisplayBlock' - $ref: '#/components/schemas/CodeDisplayBlock' - $ref: '#/components/schemas/FileTreeDisplayBlock' - $ref: '#/components/schemas/MarkdownDisplayBlock' - $ref: '#/components/schemas/KeyValueDisplayBlock' - $ref: '#/components/schemas/BadgeDisplayBlock' - $ref: '#/components/schemas/LinkDisplayBlock' - $ref: '#/components/schemas/SearchResultsDisplayBlock' - $ref: '#/components/schemas/TodoListDisplayBlock' - $ref: '#/components/schemas/ImageDisplayBlock' - $ref: '#/components/schemas/VideoDisplayBlock' - $ref: '#/components/schemas/NoteDisplayBlock' BadgeDisplayBlock: additionalProperties: false properties: text: type: string tone: enum: - muted - success - error - info - warning type: string type: enum: - badge type: string required: - type - text - tone type: object CodeDisplayBlock: additionalProperties: false properties: content: type: string language: type: string path: type: string type: enum: - code type: string required: - type - content type: object FileTreeDisplayBlock: additionalProperties: false properties: entries: items: additionalProperties: false properties: kind: enum: - file - directory type: string path: minLength: 1 type: string required: - path - kind type: object type: array type: enum: - file_tree type: string required: - type - entries type: object ImageDisplayBlock: additionalProperties: false properties: alt: type: string type: enum: - image type: string url: minLength: 1 type: string required: - type - url type: object KeyValueDisplayBlock: additionalProperties: false properties: rows: items: additionalProperties: false properties: label: type: string tone: enum: - muted - success - error - info - warning type: string value: type: string required: - label - value type: object type: array type: enum: - key_value type: string required: - type - rows type: object LinkDisplayBlock: additionalProperties: false properties: label: type: string type: enum: - link type: string url: minLength: 1 type: string required: - type - url type: object MarkdownDisplayBlock: additionalProperties: false properties: text: type: string type: enum: - markdown type: string required: - type - text type: object NoteDisplayBlock: additionalProperties: false properties: text: type: string tone: enum: - muted - success - error - info - warning type: string type: enum: - note type: string required: - type - text - tone type: object SearchResultsDisplayBlock: additionalProperties: false properties: groups: items: additionalProperties: false properties: file: minLength: 1 type: string matches: items: additionalProperties: false properties: line: format: int64 minimum: 0 type: integer text: type: string required: - line - text type: object type: array required: - file - matches type: object type: array pattern: type: string type: enum: - search_results type: string required: - type - groups type: object TerminalDisplayBlock: additionalProperties: false properties: background: type: boolean command: type: string cwd: type: string exitCode: format: int64 type: integer stderr: type: string stdout: type: string type: enum: - terminal type: string required: - type - command type: object TodoListDisplayBlock: additionalProperties: false properties: items: items: additionalProperties: false properties: status: enum: - pending - in_progress - completed type: string text: type: string required: - text - status type: object type: array type: enum: - todo_list type: string required: - type - items type: object VideoDisplayBlock: additionalProperties: false properties: poster: type: string type: enum: - video type: string url: minLength: 1 type: string required: - type - url type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ````