integrations

List AI chat import jobs

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

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
GET /ai-chat/{caseId}/import
Access token

Returns one page of AI chat import jobs for the case, newest first by default, optionally filtered by status.

Path parameters

  • caseId string Required

Query parameters

  • page number

    Default value is 1.

  • perPage number

    Default value is 10.

  • skip number

    If skip/limit not provided, page/perPage will take precedence

  • limit number

    If skip/limit not provided, page/perPage will take precedence

  • sortOrder string

    Values are asc or desc. Default value is asc.

  • status string

    Filter by job status

    Values are not_started, in_progress, completed, or failed.

  • searchText string

    Search import jobs

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • total number Required
      • page number
      • perPage number
      • skip number
      • limit number
      • totalPages number Required
      • nextPage number | null Required
      • previousPage number | null Required
      • data array[object]
        Hide data attributes Show data attributes object
        • createdAt string(date-time) Required
        • updatedAt string(date-time) Required
        • id string Required
        • case string Required
        • extractionCode string | null Required
        • file string Required
        • createdBy string Required
        • platform string Required

          Values are claude, chatgpt, or gemini.

        • status string Required

          Values are not_started, in_progress, completed, or failed.

        • startedAt string(date-time) | null Required
        • completedAt string(date-time) | null Required
        • failedAt string(date-time) | null Required
        • message string | null Required
        • aiChatProvider string | null Required
        • stats object | null Required
    • statusCode number Required
    • timestamp string(date-time) Required
GET /ai-chat/{caseId}/import 
curl \
 --request GET 'http://api.example.com/ai-chat/{caseId}/import' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "data": {
    "total": 42,
    "page": 1,
    "perPage": 20,
    "skip": 0,
    "limit": 20,
    "totalPages": 3,
    "nextPage": 2,
    "previousPage": 42.0,
    "data": [
      {
        "createdAt": "2026-01-15T14:30:00.000Z",
        "updatedAt": "2026-01-15T14:30:00.000Z",
        "id": "507f1f77bcf86cd799439011",
        "case": "65a1b2c3d4e5f6a7b8c9d0e2",
        "extractionCode": "65a1b2c3d4e5f6a7b8c9d0e2",
        "file": "65a1b2c3d4e5f6a7b8c9d0e2",
        "createdBy": "65a1b2c3d4e5f6a7b8c9d0e2",
        "platform": "claude",
        "status": "completed",
        "startedAt": "2026-01-15T14:30:00.000Z",
        "completedAt": "2026-01-15T14:32:10.000Z",
        "failedAt": "2026-05-04T09:42:00Z",
        "message": "Upload file not found",
        "aiChatProvider": "65a1b2c3d4e5f6a7b8c9d0e2",
        "stats": {
          "conversations": 12,
          "messages": 348,
          "artifacts": 0,
          "activities": 0,
          "attachments": 5
        }
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}