integrations

Unlink a case from a Smokeball matter

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
DELETE /legal/smokeball/matters/{matterId}/link
Access token

Removes the link between the case in caseId and the Smokeball matter, with its sync bookkeeping and imported participants; documents already synced and case access granted to attorneys stay. Only an org admin or owner or the case creator may unlink it (403 otherwise). Returns 400 without caseId, 404 when the case is not linked to Smokeball and 409 when it is linked to a different matter. Requires a member role or above in the organization.

Headers

  • organization string Required

    id of the selected (active) organization

Path parameters

  • matterId string Required

    matterId of the currently linked Smokeball matter

Query parameters

  • caseId string Required

    Hearsay case to unlink from the matter

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • integrationType string

        Values are clio or smokeball.

      • caseId string
      • matterId string
    • statusCode number Required
    • timestamp string(date-time) Required
DELETE /legal/smokeball/matters/{matterId}/link 
curl \
 --request DELETE 'http://api.example.com/legal/smokeball/matters/{matterId}/link?caseId=string' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"
Response examples (200) 
{
  "data": {
    "integrationType": "clio",
    "caseId": "65a1b2c3d4e5f6a7b8c9d0e2",
    "matterId": "12345"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}