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).

SDK: korely.delete_account(confirm=True). 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. The Glossary defines the words used across the docs.

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_.... Since 1.0.5 the key needs the admin permission (the API calls it a scope) and must not be confined to a project or to some end users. The key that POST /v1/agents/init returns has it from 1.0.5; the 28 init keys issued earlier have only memories:read and memories:write and can no longer close the account through the API.

A key without admin, or a confined key, answers 403 forbidden and nothing is deleted. Before 1.0.5 any key with memories:write could close the account, including a confined one. If you hold only an older init key, sign in to the dashboard with it (Account page), and close the account there: the account then has a login, and this call answers 409 account_has_login.

Query parameters

Example request

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

from korely_memory import Korely

korely = Korely(api_key="kor_live_...", region="eu")

receipt = korely.delete_account(confirm=True)

print(receipt.deleted)   # True
print(receipt.removed)   # rows removed per table

import { Korely } from "korely-memory";

const korely = new Korely({ apiKey: "kor_live_..." });

const receipt = await korely.deleteAccount({ confirm: true });

console.log(receipt.deleted); // true
console.log(receipt.removed); // rows removed per table

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. The erasure is one database transaction: if it fails, the account stays whole and you can call again.

{
  "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