Brand DNA

6 endpoints for brand dna, with parameters and a real response example.

View as Markdown Open in Claude Open in ChatGPT

GET/projects/{id}/dna

Get a project's brand DNA

Returns the project's brand DNA: business description, target audience, content preferences, tone of voice, image style, title and body fonts, and the two brand colors, together with the catalog of fonts and image styles this project can choose from, which is where the valid values for PATCH /projects/{id}/dna come from.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`locale`	query	"pt" \| "en" \| "es"

Response

{
  "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...",
  "audience": "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...",
  "imageStyle": "modern",
  "titleFont": null,
  "bodyFont": null,
  "colors": {
    "brand": "#3C50DD",
    "background": "#FDFDFF"
  },
  "options": {
    "fonts": [
      "Inter",
      "Poppins",
      "Sora",
      "Manrope",
      "Space Grotesk",
      "Fraunces",
      "Instrument Serif",
      "Bebas Neue",
      "JetBrains Mono",
      "Permanent Marker",
      "Caveat"
    ],
    "imageStyles": [
      {
        "key": "journalistic",
        "name": "Jornalístico"
      },
      {
        "key": "illustration",
        "name": "Ilustração"
      }
    ]
  }
}

PATCH/projects/{id}/dna

Update a project's brand DNA

Saves only the fields sent; anything omitted stays exactly as it is. Text fields are replaced in full, never merged; an empty text field is rejected. 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.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`description`	body	string
`targetAudience`	body	string
`contentPreferences`	body	string
`toneOfVoice`	body	string
`imageStyle`	body	string	A key from GET /projects/:id/dna's `opcoes.estilosDeImagem`.
`titleFont`	body	string	A font from GET /projects/:id/dna's `opcoes.fontes`.
`bodyFont`	body	string	A font from GET /projects/:id/dna's `opcoes.fontes`.
`brandColor`	body	string	Hex, e.g. #112233.
`backgroundColor`	body	string	Hex, e.g. #112233. This is the posts' background.

GET/projects/{id}/palettes

List a project's 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.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.

Response

{
  "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
  "ready": [
    {
      "key": "verde",
      "brandColor": "#099250",
      "schemes": [
        {
          "name": "Padrão",
          "brandColor": "#099250",
          "backgroundColor": "#F6FEF9",
          "textColor": "#1D2939"
        },
        {
          "name": "Fundo escuro",
          "brandColor": "#3CCB7F",
          "backgroundColor": "#052E1C",
          "textColor": "#FFFFFF"
        }
      ]
    },
    {
      "key": "teal",
      "brandColor": "#0E9384",
      "schemes": [
        {
          "name": "Padrão",
          "brandColor": "#0E9384",
          "backgroundColor": "#F6FEFC",
          "textColor": "#1D2939"
        },
        {
          "name": "Fundo escuro",
          "brandColor": "#2ED3B7",
          "backgroundColor": "#0A2926",
          "textColor": "#FFFFFF"
        }
      ]
    }
  ],
  "current": [
    {
      "id": "7c927623-f8c3-4f7a-8d5c-94a0d0430281",
      "name": "Padrão",
      "brandColor": "#3C50DD",
      "backgroundColor": "#FDFDFF",
      "textColor": "#1D2939",
      "hasLogo": false
    }
  ],
  "usesMoreThanOnePalette": false
}

POST/projects/{id}/palettes/apply

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.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`key`required	body	string	From GET /projects/:id/palettes, either the preset key or the brand color hex.

POST/projects/{id}/brand/photo

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. Applies to what is generated from now on.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`url`required	body	string	Must be in our public bucket.

POST/projects/{id}/brand/logo

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.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`url`required	body	string	Must be in our public bucket.