Disable a project

DELETE/v1/admin/projects/{slug}Admin key

Despite the DELETE method, this does not delete anything. It sets the project's disabledAt, the same as updating it with { "disabled": true }. Its emails, keys, templates and contacts stay.

While a project is disabled:

Requests with its API keys fail with 403 project_disabled.
RPC calls for its slug fail with 403 project_disabled.
A broadcast that is sending is canceled on its next cron tick.
Resend an email refuses its emails with 403 project_disabled.

To turn it back on, send PATCH /v1/admin/projects/:slug with { "disabled": false }, or run flaresend projects enable <slug>.

Path parameters

slugstringpathrequired

The project slug.

Response

Status 200 with the project, now with disabledAt set. Calling it on a project that is already disabled keeps the original disabledAt.

Errors

Status	Code	When
404	`project_not_found`	No project has this slug.

Request

const res = await fetch('https://mailer.example.com/v1/admin/projects/acme', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.FLARESEND_ADMIN_KEY}` },
});
const project = await res.json();

Response

{
  "id": "proj_01K6B1QZ3M8H2V5T7R9N4XW6CD",
  "slug": "acme",
  "name": "Acme",
  "defaultFrom": "Acme <hello@acme.com>",
  "allowedDomains": ["acme.com"],
  "allowedSenders": null,
  "domainSenders": {},
  "rpcEnabled": true,
  "dailyLimit": 5000,
  "trackOpens": false,
  "trackClicks": false,
  "broadcastsEnabled": false,
  "createdAt": "2026-09-26T10:00:00.000Z",
  "updatedAt": "2026-09-27T08:15:00.000Z",
  "disabledAt": "2026-09-27T08:15:00.000Z"
}

Path parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Path parameters

Response

Errors