Delete a test

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

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.