List the versions of an AI prompt (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

GET /ai/admin/prompts/{purpose}

Access token

Lists every stored version of one prompt purpose, newest first. An unknown purpose returns 400. Super admins only.

Path parameters

purpose string Required

Values are chunk_summary, period_summary, conversation_summary, case_summary, case_context_filing_extraction, relevance_gate, evidentiary_map_element, or tag_suggestion.

Responses

200 application/json
Hide response attributes Show response attributes object
- data array[object] Required
  
  Hide data attributes Show data attributes object
  
  _id string
  
  purpose string
  
  Values are chunk_summary, period_summary, conversation_summary, case_summary, case_context_filing_extraction, relevance_gate, evidentiary_map_element, or tag_suggestion.
  
  versionSlug string
  
  systemPrompt string
  
  toolName string
  
  toolDescription string
  
  toolInputSchema object
  
  JSON Schema of the tool input.
  
  model string
  
  maxTokens number
  
  temperature number
  
  isActive boolean
  
  notes string
  
  createdBy string | null
  
  updatedBy string | null
  
  createdAt string(date-time) | null
  
  updatedAt string(date-time) | null
- statusCode number Required
- timestamp string(date-time) Required

GET /ai/admin/prompts/{purpose}

curl \
 --request GET 'http://api.example.com/ai/admin/prompts/{purpose}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [
    {
      "_id": "65a1b2c3d4e5f6a7b8c9d0e1",
      "purpose": "case_summary",
      "versionSlug": "case_summary.v2",
      "systemPrompt": "string",
      "toolName": "string",
      "toolDescription": "string",
      "toolInputSchema": {},
      "model": "sonnet",
      "maxTokens": 1024,
      "temperature": 0.2,
      "isActive": true,
      "notes": "string",
      "createdBy": "65a1b2c3d4e5f6a7b8c9d0e4",
      "updatedBy": "65a1b2c3d4e5f6a7b8c9d0e4",
      "createdAt": "2026-01-15T10:15:00.000Z",
      "updatedAt": "2026-01-15T10:15:00.000Z"
    }
  ],
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}