Delete a session
curl --request DELETE \
--url https://api.healos.ai/ext-api/v1/sessions/{sessionId} \
--header 'X-API-Key: <api-key>'const options = {method: 'DELETE', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.healos.ai/ext-api/v1/sessions/{sessionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.healos.ai/ext-api/v1/sessions/{sessionId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text){
"data": {
"session_id": "<string>",
"status": "deleted",
"changed": true
}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Rate limit exceeded. Please retry after the window resets.",
"code": "daily_cap_reached",
"reset_at": "2026-10-28T00:00:00.000Z"
}Sessions
Delete a session
Moves the session and its notes to the recycle bin, the same as deleting a visit in the dashboard. It can be restored with POST /sessions//restore. This never deletes permanently: a session already in the bin is left as it is (changed: false). Emptying the bin stays in the dashboard. Returns 404 if the session isn’t your organization’s. Requires notes:write.
DELETE
/
sessions
/
{sessionId}
Delete a session
curl --request DELETE \
--url https://api.healos.ai/ext-api/v1/sessions/{sessionId} \
--header 'X-API-Key: <api-key>'const options = {method: 'DELETE', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.healos.ai/ext-api/v1/sessions/{sessionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.healos.ai/ext-api/v1/sessions/{sessionId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text){
"data": {
"session_id": "<string>",
"status": "deleted",
"changed": true
}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "Rate limit exceeded. Please retry after the window resets.",
"code": "daily_cap_reached",
"reset_at": "2026-10-28T00:00:00.000Z"
}| Requirement | Detail |
|---|---|
| Scope | notes:write |
| Rate limit | About 60 requests per minute per API key (shared by all endpoints; approximate) |
| Cost | Free |
Safety
- Writes data: Yes. Moves the session and its notes to the recycle bin. It is not a permanent delete: restore it with Restore a deleted session. Emptying the recycle bin is only possible in the dashboard.
- Safe to retry: Yes. A repeat finds the session already in the bin, changes nothing and returns
changed: false. - Contacts an outside system: None. Notes already sent to an EHR stay there.
- Dry run: Not available.
Rolling out: this endpoint is on staging first and not yet on
api.healos.ai.GET /sessions/{sessionId} or the notes endpoints. Another organization’s session is a 404.
Guide: Making requests. Errors: Error catalog.Was this page helpful?

