Users & agents

Delete the account

Close an account created with POST /v1/agents/init, using its own key. The account, every key, project, memory, fact, webhook and audit event goes. Korely keeps two things: the account's model-cost rows, by day, with no agent, memory or end user, and a record of the erasure (the account id, a keyed digest of its email when it has one, and the rows erased per table).

An account created by POST /v1/agents/init has no login: the key is the account. This is how you close it. The delete is physical and cannot be undone, and the key stops working as soon as the call returns.

An account you sign in to (the dashboard at agent.korely.ai) does not close with a key, so a key that ends up in a log cannot delete an account. Close it from the dashboard: Account, Close the account. That removes its data and keys too.

To erase one of your customers instead, use DELETE /v1/users/{end_user}/memories.

Authentication

HTTP header, required: Authorization: Bearer kor_live_.... The key needs the memories:write scope.

Query parameters

Example request

curl -X DELETE "https://api.korely.ai/v1/account?confirm=true" \
  -H "Authorization: Bearer kor_live_..."

import requests

r = requests.delete(
    "https://api.korely.ai/v1/account",
    params={"confirm": "true"},
    headers={"Authorization": "Bearer kor_live_..."},
)
print(r.json())

const r = await fetch("https://api.korely.ai/v1/account?confirm=true", {
  method: "DELETE",
  headers: { Authorization: "Bearer kor_live_..." },
});
console.log(await r.json());

Response

200 OK. The rows the account had, by table, counted when it was closed (only tables that had rows). agent_llm_usage, when present, counts the cost rows that were kept without the account.

{
  "deleted": true,
  "removed": {
    "agent_facts": 31,
    "agent_memories": 12,
    "audit_events": 58,
    "agent_api_keys": 1,
    "agent_rate_limits": 5,
    "hosted_accounts": 1,
    "hosted_usage_months": 1,
    "agent_llm_usage": 24,
    "agent_projects": 1
  }
}

Errors