Brand DNA

Get a project's brand DNA

Returns every field of the project's brand DNA, the same set the app's DNA screen shows: what the business is and who it speaks to, tone of voice, the language Posttar writes in, image and design style, fonts, colors and background texture, the caption footer, how many slides a carousel starts with, which layouts generation may use, and the name, @, photo and logo that sign the artwork. photoUrl is the photo in use on the artwork: the override if there is one, otherwise the connected Instagram account's photo. photoOverride is what POST /projects/{id}/brand/photo writes (null means the account's photo applies). identity is the name, @ and photo that sign the artwork right now. logoUrl is the first palette's logo, the one /brand/logo writes. colors and textColor are the colors the brand chose; a default the brand never picked comes back as null even though the artwork still has a color. It also carries, in options, the catalog of fonts, image styles, design styles and textures this project can choose from, which is where the valid values for PATCH /projects/{id}/dna come from. Read this before writing: it is the only place those keys exist.

{
  "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
  "projectName": "Projeto de teste",
  "description": "A Posttar é uma ferramenta da VINTTI Soluções Digitais que automatiza a criação, personalização, agendamento e publicação de carrosséis no Instagram. Gera textos e imagens, revi...",
  "targetAudience": "Pessoas, marcas e empresas que querem manter constância no Instagram, mas não têm tempo, equipe ou conhecimento para criar carrosséis. Fala especialmente com empreendedores, neg...",
  "contentPreferences": "Priorizar conteúdos práticos sobre crescimento no Instagram, constância, automação, criação de carrosséis, identidade visual, geração de leads e produtividade. Mostrar como a fe...",
  "toneOfVoice": "Escreva em português, de forma direta, simples e comercial, com frases curtas e foco no benefício. Use linguagem acessível, evitando excesso de termos técnicos. Fale com quem qu...",
  "instagramSwitch": null,
  "imageStyle": "modern",
  "titleFont": null,
  "bodyFont": null,
  "colors": {
    "brand": "#3C50DD",
    "background": "#FDFDFF"
  },
  "photoUrl": "https://.../post-images/profiles/c85848ba/17841400000000000.jpg",

Update a project's brand DNA

Changes any field of the brand DNA, the same set the app's DNA screen writes. Saves only the fields sent; anything omitted stays exactly as it is. Text is replaced in full, never merged, and the four that describe the brand (description, targetAudience, contentPreferences, toneOfVoice) refuse an empty value instead of erasing it: clearing those is done on the DNA screen, where you see what you are clearing. captionSuffix, profileNameOverride and profileHandleOverride are the opposite, and an empty string CLEARS them, which is how you remove a footer or go back to the connected account's name. Colors must be hex. Applies to what Posttar generates from now on: no existing post, caption, or slide text is rewritten, and an already published post never changes.

{
  "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
  "changed": [],
  "palette": "updated",
  "paletteName": "Default",
  "otherPalettes": 0
}

List color palettes

Posttar's ready-made color palettes, each with the key POST /projects/{id}/palettes/apply accepts, plus the colors this project uses today.

{
  "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
  "ready": [
    {
      "key": "green",
      "brandColor": "#099250",
      "schemes": [
        {
          "name": "Default",
          "brandColor": "#099250",
          "backgroundColor": "#F6FEF9",
          "textColor": "#1D2939"
        },
        {
          "name": "Dark background",
          "brandColor": "#3CCB7F",

Apply a color palette

Replaces the brand's colors with one of the ready-made palettes (or the project's own brand color hex), preserving the logo. Applies to what Posttar generates from now on; an already published post never changes.

{
  "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
  "palette": "green",
  "replaced": 1,
  "created": 3,
  "logoKept": true,
  "usesMoreThanOnePalette": false
}

Set the brand's round photo

Replaces the round photo shown in the header of the slides. url must already be in Posttar's public bucket. What this writes is photoOverride in GET /projects/{id}/dna; photoUrl there is the photo in use. Applies to what is generated from now on.

{
  "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
  "url": "https://.../post-images/posts/c85848ba/ee1e8a72_slide_1_render.png"
}

Set the brand's logo

Replaces the logo stamped on the slides' artwork. url must already be in Posttar's public bucket. Applies to every palette of the project at once.

{
  "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
  "url": "https://.../post-images/posts/c85848ba/ee1e8a72_slide_1_render.png",
  "palettesUpdated": 3
}