---
title: "End a care chat"
method: DELETE
path: "/care/chats/{chatId}"
tags: ["Embedded Care"]
---

# End a care chat

`DELETE /care/chats/{chatId}`

## Request

- Base URL: `https://api.lightspark.com/grid/2025-10-13`
- URL: `https://api.lightspark.com/grid/2025-10-13/care/chats/{chatId}`
- Auth: HTTP basic

Close a chat the cardholder has finished with or navigated away from. The
conversation stops accepting messages; sending one afterwards is refused
with `CARE_CHAT_ENDED`, and the cardholder starts a new chat by sending
another message.

No session token is required, even on a verified chat. Ending a chat
touches no account data, and requiring a live session would mean a partner
whose cardholder walked away could not close the chat without texting them
another code first. The chat only has to belong to the calling platform.

Closing a chat that is already closed is not an error: that is the state
the caller asked for.

Requires a token with the `VIEW` permission.

## Response `204`

The chat is closed. No content.

## Other responses

- `401`: `UNAUTHORIZED`: the platform's Grid credential is missing or wrong.
- `403`: `FORBIDDEN`: the token lacks the `VIEW` permission, or embedded care is not enabled for this platform.
- `404`: `NOT_FOUND`: no such chat for this platform. A chat that belongs to another platform, one that never existed, and a malformed chat id are one answer.
- `429`: `RATE_LIMITED`: the platform is calling this endpoint too often. Back off for the interval in the `Retry-After` header.
- `500`: Internal service error.
- `503`: `SERVICE_UNAVAILABLE` when embedded care is not available in this deployment, or the support agent is temporarily turned off.

## Changes

> 115 revisions in range; 2 not diffed.

- **2026-10-17** `661b7d710fd2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/care/chats/:chatId/delete.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightsparkdev/apis/grid-api/revisions/7a1db46ec552?raw)