# Remove or block leads from your code (/docs/leads/hide-delete/api)

Authenticated with `?privateKey=YOUR_KEY` (see [Authentication](/docs/authentication)).

<Endpoints ops={["POST /v3/leads/{leadId}/hide", "POST /v3/leads/delete"]} />

<ApiPlayground
  ops={["POST /v3/leads/{leadId}/hide", "POST /v3/leads/delete"]}
  method="post"
  path="/v3/leads/{leadId}/hide"
  tool="hide_lead"
  args={`{
  "leadId": "",
  "hide": true
}`}
/>

## Use case: Hide test leads [#use-case-hide-test-leads]

`POST /v3/leads/{leadId}/hide` with `{ "hide": true }` hides one lead; `POST /v3/leads/delete` with `{ "leadIds": [...] }` deletes several for good.