Generated from Postwind commit a19b2e4 OpenAPI 0.1.0 synced

Projects HTTP API

GET/api/v1/projects/{project_id}

get_project

Reads one project with all its settings.

Call it
to check a project’s defaults before creating campaigns, or whether it is deleted.
Needs
the project’s id and an admin key, or a project key with scope read for its own project (another project’s id is not_found).
Returns
the project (deleted_at is set once it is deleted), the same as GET /api/v1/projects/{project_id}.

Arguments

No other arguments are accepted.

Result

The result comes back as structuredContent, with the same JSON as a text block.

  • 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.

PageLanguage

The language of the public pages.

string · enum

  • en
  • ru

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: GET /api/v1/projects/{project_id}