Accounts

Delete an account

Required permissions: accounts:delete.

Soft delete. Returns 200, not 204, with the account as it was — nothing in the response body distinguishes it from a normal GET, and there is no deletedAt field in this API's Account shape. The proof of deletion is behavioral: this id now 404s (account_not_found) on the account routes, is rejected as a POST /v1/discoveries accountIds entry with a 400 (unknown_account), and no longer appears in GET /v1/accounts. Only the account record goes: the events and people already discovered for it stay, so GET /v1/events and GET /v1/people keep returning rows carrying the deleted accountId.

delete/v1/accounts/{id}

Request

  • Base URL: https://api.trayo.ai
  • URL: https://api.trayo.ai/v1/accounts/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

The account as it existed immediately before deletion.

idstring uuid required
namestring required
urlstring uri nullable required

The company's website as an absolute HTTP or HTTPS URL, or null when this workspace does not know one. null is expected rather than exceptional: an account created from a company NAME alone — by POST /v1/people with a company carrying no domain, or by a Trayo import — has no website until one is supplied. Set it with PATCH /v1/accounts/{id} (trayo_update_account over MCP). logoUrl is null for exactly these accounts, because it is derived from this field.

logoUrlstring nullable required

The account's logo URL. Derived from url, so it is present for every account whose url is a usable domain and null otherwise. Cannot be set through this API. The URL returns image bytes (200) or redirects to them (302), so it is usable directly as an <img src>; it answers 404 when no logo resolves for the domain. Fetching it needs no API key.

linkedinHandlestring nullable required
starredboolean required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.