# Delete a test

Permanently delete a test. Scope: tests:write.

Permanently deletes a test (relation teardown + org usage decrement). **Scope:** `tests:write`. Visibility-gated (404 if not visible to the key), then requires employer-write authority in one of the test's organizations (admins bypass; a platform-global test with no organization is admin-only).

## Path parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `id` | string | The test id. |

## Example request

```bash
curl -X DELETE https://app.talent-ray.com/api/v1/tests/test_js \
  -H "Authorization: Bearer tr_YOUR_KEY"
```

## Response

`204 No Content` — the test was deleted.

## Status codes

| Status | Meaning |
| --- | --- |
| `204` | Deleted. |
| `401` | No valid API key. |
| `403` | `insufficient_scope` (missing `tests:write`) or `forbidden` (no write authority in the test's org). |
| `404` | Not found, or not visible to the key. |
| `429` | Rate limit exceeded. |