Generated from Postwind commit a19b2e4 OpenAPI 0.1.0 synced

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), effect in words and the project as get_project returns it after the call; the API’s DELETE /api/v1/projects/{project_id} answers 204.

Arguments

  • object
  • project_idstring · uuidrequired

    The project’s id.

  • confirmboolean

    true deletes 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
  • effectstring

    The outcome in words, for the agent and its user.

  • outcomeOutcome

    What a call of delete_project or delete_list did.

    would_delete A dry run: nothing changed; a call with confirm: true deletes.

    deleted Deleted now.

    already_deleted Deleted before; nothing changed.

  • projectProject

    The project as it is now.

    7 fields
    • Project object · all fields required
    • created_atstring · date-time
    • deleted_atstring · date-time | null

      When the project was deleted; null while it is live. A deleted project can only be read.

    • idstring · uuid
    • namestring
    • A project’s settings, every field present.

      11 fields
      • ProjectSettings object · all fields required
      • auto_footerboolean

        Add an unsubscribe footer when a template has none.

      • brandingBranding

        How the public pages look.

        4 fields
        • Branding object · all fields required
        • brand_namestring | null
        • languagePageLanguage

          The language of the public pages.

          • en
          • ru
        • support_emailstring | null
        • text_overridesmap of string → string

          Texts of the pages by key.

      • daily_send_quotainteger · uint32 | null

        Most messages a day; null: no quota.

        ≥ 0

      • default_throttle_per_hourinteger · uint32 | null

        Default campaign speed, messages an hour; null: no limit.

        ≥ 0

      • dns_credentialsDnsCredentials

        Which DNS providers the project set its own credentials for; the credentials themselves are never returned.

        1 fields
        • DnsCredentials object · all fields required
        • porkbunboolean

          Whether the project set its own Porkbun credentials.

      • from_emailstring | null

        Default sender address of campaigns.

      • from_namestring | null

        Default sender name of campaigns.

      • reply_tostring | null

        Default Reply-To.

      • soft_bounce_suppress_afterinteger · uint32 | null

        Soft bounces in a row after which an address is suppressed; null: off.

        ≥ 0

      • trackingTracking

        What campaigns track by default.

        2 fields
        • Tracking object · all fields required
        • clicksboolean
        • opensboolean
      • transportstring | null

        Default transport, direct or relay:<name>; null: the node’s default.

    • slugstring

      Unique among live projects; it never changes.

    • updated_atstring · date-time

      The latest change: creation, rename, settings, deletion.

Definitions

Branding

How the public pages look.

  • object · all fields required
  • brand_namestring | null
  • languagePageLanguage

    The language of the public pages.

    • en
    • ru
  • support_emailstring | null
  • text_overridesmap of string → string

    Texts 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
  • porkbunboolean

    Whether 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 | null

    When the project was deleted; null while it is live. A deleted project can only be read.

  • idstring · uuid
  • namestring
  • A project’s settings, every field present.

    see ProjectSettings

  • slugstring

    Unique among live projects; it never changes.

  • updated_atstring · date-time

    The latest change: creation, rename, settings, deletion.

ProjectSettings

A project’s settings, every field present.

  • object · all fields required
  • auto_footerboolean

    Add an unsubscribe footer when a template has none.

  • brandingBranding

    How the public pages look.

    see Branding

  • daily_send_quotainteger · uint32 | null

    Most messages a day; null: no quota.

    ≥ 0

  • default_throttle_per_hourinteger · uint32 | null

    Default campaign speed, messages an hour; null: no limit.

    ≥ 0

  • dns_credentialsDnsCredentials

    Which DNS providers the project set its own credentials for; the credentials themselves are never returned.

    see DnsCredentials

  • from_emailstring | null

    Default sender address of campaigns.

  • from_namestring | null

    Default sender name of campaigns.

  • reply_tostring | null

    Default Reply-To.

  • soft_bounce_suppress_afterinteger · uint32 | null

    Soft bounces in a row after which an address is suppressed; null: off.

    ≥ 0

  • trackingTracking

    What campaigns track by default.

    see Tracking

  • transportstring | null

    Default transport, direct or relay:<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}