Skip to content

list_brandings

Returns the workspace’s brand kits — tone of voice, audience, keywords, and reference style images. Use one to keep drafted copy on-brand, and pass its id to generate_image for visuals that match.

On this page
  1. Parameters
  2. Example request
  3. Response
Category
Channels
REST
POST/api/tools/list_brandings

Parameters

workspaceId
stringoptional
Workspace to act on, from list_workspaces. Omit to use the default workspace on the key.

Example request

curl -X POST "https://api.postmcpai.com/api/tools/list_brandings" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $POSTMCPAI_API_KEY"

Response

An array of brand kits.

200 · application/json
[
  {
    "id": "66f2b8a1c0de4471aa02",
    "name": "Acme Product Voice",
    "tone": "Direct, technical, lightly playful",
    "audience": "Backend engineers and platform teams",
    "keywords": [
      "automation",
      "developer experience"
    ],
    "styleImage": "https://postmcpai.com/assets/acme-style.png"
  }
]