Data erasure

Free · all plans

Delete a chart with everything derived from it, or all of your data at once. Both are immediate and cannot be undone. See Data & privacy for developers.

DELETE /v1/charts/{chart_id} — one chart

Scope: charts:write. Deletes the chart and everything computed from it: compatibility reports that involve it, interpretations, LLM interpretations, reports and their PDF/HTML files, the skill profile, feedback, and the cached chart.

curl -X DELETE https://api.astrolinkers.com/v1/charts/$CHART_ID \
  -H "Authorization: Bearer $ASTROLINKERS_API_KEY"

Status	Meaning
204	Deleted.
404	No such chart in your account (also for another account's id, and for a second delete).
403 missing_scope	The key lacks charts:write.

DELETE /v1/tenant/data — everything

Scope: charts:write. Deletes every chart of your account and everything derived from them. Your account, API keys and usage history stay. The body must carry the exact phrase, so it cannot happen by accident:

curl -X DELETE https://api.astrolinkers.com/v1/tenant/data \
  -H "Authorization: Bearer $ASTROLINKERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"confirm": "DELETE ALL DATA"}'

{
  "tenant_id": "019e…",
  "charts_deleted": 12,
  "rows_deleted": 31,
  "rows_by_store": {
    "compatibility_reports": 4,
    "feedback_entries": 0,
    "interpretations": 6,
    "llm_interpretations": 0,
    "reports": 2,
    "skill_profiles": 7,
    "charts": 12
  },
  "report_files_deleted": 2,
  "cache_entries_deleted": 12
}

Status	Meaning
200	Deleted; the body says what was removed.
422 confirmation_required	The phrase is missing or different.
403 missing_scope	The key lacks charts:write.

Both calls are safe to repeat: a second call removes nothing more. Daily database backups that still contain the data roll off within 14 days.