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

# Get Tool Output

> Retrieve cached tool output data by cache key.

This endpoint allows users to fetch complete, untruncated tool outputs
that were cached during tool execution.

Requires READ permission on ANALYSIS resources.



## OpenAPI

````yaml https://analyst.heyhumm.ai/api/openapi.json get /cache/tool-output/{cache_key}
openapi: 3.1.0
info:
  title: Analyst API
  description: API for the Analyst service with proper organization-scoped permissions
  version: 1.0.0
servers:
  - url: https://analyst.heyhumm.ai
security: []
paths:
  /cache/tool-output/{cache_key}:
    get:
      tags:
        - cache
      summary: Get Tool Output
      description: |-
        Retrieve cached tool output data by cache key.

        This endpoint allows users to fetch complete, untruncated tool outputs
        that were cached during tool execution.

        Requires READ permission on ANALYSIS resources.
      operationId: get_tool_output_cache_tool_output__cache_key__get
      parameters:
        - name: cache_key
          in: path
          required: true
          schema:
            type: string
            description: Cache key for the tool output
            title: Cache Key
          description: Cache key for the tool output
        - name: organization_id
          in: query
          required: true
          schema:
            type: string
            title: Organization Id
        - name: thread_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Thread ID for S3 cache lookup (optional)
            title: Thread Id
          description: Thread ID for S3 cache lookup (optional)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolOutputResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    ToolOutputResponse:
      properties:
        data:
          title: Data
          description: Cached tool output payload
        cache_key:
          type: string
          title: Cache Key
          description: Cache key used to retrieve the tool output
        cached_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Cached At
          description: Timestamp when the output was cached, if available
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
          description: Generated code associated with the cached output, if available
        code_language:
          anyOf:
            - type: string
            - type: 'null'
          title: Code Language
          description: Language for the generated code, if available
        inputs:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Inputs
          description: Tool inputs captured alongside the cached output, if available
      type: object
      required:
        - data
        - cache_key
      title: ToolOutputResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````