> ## 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. # Get the image one of a task's screen captures returned > Reads the image a screenshot or screen read in a task's transcript returned, as the URL to draw it from. Use this tool when you need to: - Draw a finished surface session's latest screen without reading its steps - See what the agent saw when it took a screenshot Examples: - GET /tasks/{taskID}/captures/{toolCallID} - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/captures/toolu_01A2B3C4D5E6F7G8H9J0K1L2 Hints: - taskID is the task's uuid; toolCallID is the capture's tool call id, path-escaped: a surface_session outline entry's latest_capture_tool_call_id, or the id of a screenshot call in listTaskTurnMessages. - Answers url: the http(s) URL the workspace uploaded the capture to when its result names one, else the inline image as a data:image/...;base64 URL, with Cache-Control private, no-store. A later settlement of the call can replace its result, so a reader keys what it keeps by the turn's revision_sequence. - A screen capture is a screenshot (desktop, browser or device), a device screen read, or an Android batch (android-use), which returns the screen with its report; an iOS batch (ios-use) is not one, since it returns only its report. - Use listTaskTurns instead to find a finished turn's surface sessions and their latest captures. - Owners, admins, members and viewers of the task's organization may read it; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and an agent host's grant with 403 agent_host_route_not_allowed; 503 when the membership check is unavailable. - 404 for a task the caller cannot see, a tool call the task does not have, a call that is not a screen capture, and a capture whose result holds no image it can draw. ## OpenAPI ````yaml api-reference/openapi.json GET /tasks/{taskID}/captures/{toolCallID} openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /tasks/{taskID}/captures/{toolCallID}: get: tags: - tasks summary: Get the image one of a task's screen captures returned description: >- Reads the image a screenshot or screen read in a task's transcript returned, as the URL to draw it from. Use this tool when you need to: - Draw a finished surface session's latest screen without reading its steps - See what the agent saw when it took a screenshot Examples: - GET /tasks/{taskID}/captures/{toolCallID} - GET /tasks/6f1c2a9e-3b7d-4c55-9a2e-0d8b1f4e7c21/captures/toolu_01A2B3C4D5E6F7G8H9J0K1L2 Hints: - taskID is the task's uuid; toolCallID is the capture's tool call id, path-escaped: a surface_session outline entry's latest_capture_tool_call_id, or the id of a screenshot call in listTaskTurnMessages. - Answers url: the http(s) URL the workspace uploaded the capture to when its result names one, else the inline image as a data:image/...;base64 URL, with Cache-Control private, no-store. A later settlement of the call can replace its result, so a reader keys what it keeps by the turn's revision_sequence. - A screen capture is a screenshot (desktop, browser or device), a device screen read, or an Android batch (android-use), which returns the screen with its report; an iOS batch (ios-use) is not one, since it returns only its report. - Use listTaskTurns instead to find a finished turn's surface sessions and their latest captures. - Owners, admins, members and viewers of the task's organization may read it; a billing member is refused with 403 org_role_insufficient, a suspended organization with 403 org_suspended, and an agent host's grant with 403 agent_host_route_not_allowed; 503 when the membership check is unavailable. - 404 for a task the caller cannot see, a tool call the task does not have, a call that is not a screen capture, and a capture whose result holds no image it can draw. operationId: getTaskConversationCapture 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 - description: >- The screen capture's tool call id: a surface session digest's latest_capture_tool_call_id. in: path name: toolCallID required: true schema: description: >- The screen capture's tool call id: a surface session digest's latest_capture_tool_call_id. minLength: 1 type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/Capture' description: OK headers: Cache-Control: schema: type: string '401': content: application/json: schema: $ref: '#/components/schemas/TasksErrorResponse' description: Unauthorized '403': content: application/json: schema: anyOf: - $ref: '#/components/schemas/TasksErrorResponse' - $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/TasksErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/TasksErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/TasksErrorResponse' description: Internal Server Error '503': content: application/json: schema: $ref: '#/components/schemas/TasksErrorResponse' description: Service Unavailable components: schemas: Capture: additionalProperties: false properties: url: description: >- The image to draw: the http(s) URL the workspace uploaded the capture to when its result names one, else the inline image as a data:image/...;base64 URL. minLength: 1 type: string required: - url type: object TasksErrorResponse: additionalProperties: false properties: code: enum: - account_deleting - aether_inference_unserved - agent_pr_blocked - agent_pr_pending - agent_profile_changed - app_identity_missing - attribution_unavailable - bad_gateway - bad_request - caller_inactive - conflict - connection_harness_mismatch - connection_not_held - contents_write_required - continuation_failed - continuation_unavailable - control_forbidden - creator_github_access_missing - embeddings_unavailable - fix_not_requested - fix_requests_unrecorded - forbidden - fork_branch_delete_unsupported - fork_forbidden - gateway_timeout - github_claim_unverified - github_failed - github_identity_mismatch - github_identity_required - github_push_access_required - github_reconnect_required - github_ref_not_found - gone - handed_branch_protected - head_moved - html_render_nul_byte - html_render_too_large - idempotency_key_conflict - idempotency_key_reused - inference_proxy_unavailable - insufficient_credits - insufficient_inference_balance - internal_error - invalid_request - last_queued_message - mcp_server_not_connected - message_not_queued - method_not_allowed - mode_forbidden - no_dispatch_target - not_acceptable - not_found - not_implemented - onboarding_already_completed - onboarding_requirements_missing - org_id_required - org_role_insufficient - org_suspended - payment_required - pr_review_actor_required - pr_review_publish_forbidden - precondition_failed - project_archived - project_has_no_repository - project_repo_disconnected - project_repository_differs - project_required - pull_request_closed - pull_request_mirror_failed - pull_request_not_mirrored - push_file_too_large - push_rejected - push_secret_detected - queued_stop_requires_discard - rate_limited - repository_administration_not_granted - repository_already_connected - repository_create_forbidden - repository_create_rejected - repository_created_not_linked - repository_owner_not_caller - request_canceled - request_timeout - request_too_large - save_in_progress - save_requires_task_creator - service_unavailable - stack_cycle - stack_too_large - stack_two_parents - stale_execution - stale_or_indeterminate - stale_pending_input - stream_delivery_gap - stream_event_conflict - task_already_saved - task_awaiting_message - task_awaiting_tool_response - task_bound_at_creation - task_branch_diverged - task_branch_is_default - task_branch_mismatch - task_branch_missing - task_connection_disconnected - task_creator_deleted - task_executing - task_file_too_large - task_has_no_commits - task_has_no_files - task_has_no_repository - task_history_has_merges - task_ineligible - task_is_child - task_not_accepting_messages - task_not_pinnable - task_not_started - task_rebase_in_progress - task_settings_changed - teleport_unavailable - unauthenticated - unsigned_aether_head - unsigned_commit - unsupported_changes - unsupported_media_type - untyped_error - validation_failed - working_tree_dirty - workspace_git_unavailable - workspace_gone - workspace_outdated - workspace_rejected minLength: 1 type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error - code type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting - agent_host_route_not_allowed - credential_kind_not_admitted type: string error: minLength: 1 type: string required: - error - code 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 securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.