Projectsrequires confirm HTTP API
DELETE/api/v1/projects/{project_id}
delete_project
Deletes a project: it refuses every change from then on, admin keys can still read it, and its slug becomes free.
- Call it
- when a project is no longer used.
- Needs
- an admin key and
confirm: true; without it the call changes nothing and tells what it would do. - Returns
outcome(would_delete,deleted,already_deleted),effectin words and the project asget_projectreturns it after the call; the API’sDELETE /api/v1/projects/{project_id}answers 204.
Arguments
- object
-
project_idstring · uuidrequiredThe project’s id.
-
confirmbooleantruedeletes the project. Without it the call only tells what would happen and changes nothing.default
false
No other arguments are accepted.
Result
The result comes back as structuredContent, with the same JSON as a text block.
- object · all fields required
-
effectstringThe outcome in words, for the agent and its user.
-
outcomeOutcomeWhat a call of
delete_projectordelete_listdid.would_deleteA dry run: nothing changed; a call withconfirm: truedeletes.deletedDeleted now.already_deletedDeleted before; nothing changed. -
projectProjectThe project as it is now.
7 fields
- Project object · all fields required
-
created_atstring · date-time -
deleted_atstring · date-time | nullWhen the project was deleted;
nullwhile it is live. A deleted project can only be read. -
idstring · uuid -
namestring -
settingsProjectSettingsA project’s settings, every field present.
11 fields
- ProjectSettings object · all fields required
-
auto_footerbooleanAdd an unsubscribe footer when a template has none.
-
brandingBrandingHow the public pages look.
4 fields
- Branding object · all fields required
-
brand_namestring | null -
languagePageLanguageThe language of the public pages.
- en
- ru
-
support_emailstring | null -
text_overridesmap of string → stringTexts of the pages by key.
-
daily_send_quotainteger · uint32 | nullMost messages a day;
null: no quota.≥ 0
-
default_throttle_per_hourinteger · uint32 | nullDefault campaign speed, messages an hour;
null: no limit.≥ 0
-
dns_credentialsDnsCredentialsWhich DNS providers the project set its own credentials for; the credentials themselves are never returned.
1 fields
- DnsCredentials object · all fields required
-
porkbunbooleanWhether the project set its own Porkbun credentials.
-
from_emailstring | nullDefault sender address of campaigns.
-
from_namestring | nullDefault sender name of campaigns.
-
reply_tostring | nullDefault
Reply-To. -
soft_bounce_suppress_afterinteger · uint32 | nullSoft bounces in a row after which an address is suppressed;
null: off.≥ 0
-
trackingTrackingWhat campaigns track by default.
2 fields
- Tracking object · all fields required
-
clicksboolean -
opensboolean
-
transportstring | nullDefault transport,
directorrelay:<name>;null: the node’s default.
-
slugstringUnique among live projects; it never changes.
-
updated_atstring · date-timeThe latest change: creation, rename, settings, deletion.
Definitions
Branding
How the public pages look.
- object · all fields required
-
brand_namestring | null -
languagePageLanguageThe language of the public pages.
- en
- ru
-
support_emailstring | null -
text_overridesmap of string → stringTexts of the pages by key.
DnsCredentials
Which DNS providers the project set its own credentials for; the credentials themselves are never returned.
- object · all fields required
-
porkbunbooleanWhether the project set its own Porkbun credentials.
Outcome
What a call of delete_project or delete_list did.
string · enum
would_delete A dry run: nothing changed; a call with confirm: true deletes.
deleted Deleted now.
already_deleted Deleted before; nothing changed.
PageLanguage
The language of the public pages.
string · enum
- en
- ru
Project
A project (create_project, get_project, update_project_settings;
GET /api/v1/projects/{project_id}).
- object · all fields required
-
created_atstring · date-time -
deleted_atstring · date-time | nullWhen the project was deleted;
nullwhile it is live. A deleted project can only be read. -
idstring · uuid -
namestring -
settingsProjectSettingsA project’s settings, every field present.
see ProjectSettings
-
slugstringUnique among live projects; it never changes.
-
updated_atstring · date-timeThe latest change: creation, rename, settings, deletion.
ProjectSettings
A project’s settings, every field present.
- object · all fields required
-
auto_footerbooleanAdd an unsubscribe footer when a template has none.
-
brandingBrandingHow the public pages look.
see Branding
-
daily_send_quotainteger · uint32 | nullMost messages a day;
null: no quota.≥ 0
-
default_throttle_per_hourinteger · uint32 | nullDefault campaign speed, messages an hour;
null: no limit.≥ 0
-
dns_credentialsDnsCredentialsWhich DNS providers the project set its own credentials for; the credentials themselves are never returned.
see DnsCredentials
-
from_emailstring | nullDefault sender address of campaigns.
-
from_namestring | nullDefault sender name of campaigns.
-
reply_tostring | nullDefault
Reply-To. -
soft_bounce_suppress_afterinteger · uint32 | nullSoft bounces in a row after which an address is suppressed;
null: off.≥ 0
-
trackingTrackingWhat campaigns track by default.
see Tracking
-
transportstring | nullDefault transport,
directorrelay:<name>;null: the node’s default.
Tracking
What campaigns track by default.
- object · all fields required
-
clicksboolean -
opensboolean
Errors
A failed call answers isError: true with a code from the same table as the HTTP API, and detail. How tools report errors
HTTP API
The same operation over HTTP: DELETE /api/v1/projects/{project_id}