List post formats

The shapes viral posts keep using, each with the question Postel asks before writing one. Write one with POST /v1/viral/takes and your answer to its question.

Request

curl -X GET "https://www.postel.app/api/v1/viral/formats"

curl -X GET "https://www.postel.app/api/v1/viral/formats"

Response

200

{
  "formats": [
    {
      "id": "the-numbers",
      "name": "The numbers",
      "why": "A real figure stops the scroll, and the decisions behind it are what readers save.",
      "question": "What's a number from your work you'd stand behind?",
      "placeholder": "40 demo calls in October, all from replying to posts, about 20 minutes a day"
    }
  ]
}

Try it

Authorization

bearerAuth

AuthorizationBearer <token>

A Postel API key, Authorization: Bearer pstl_…. Create one in Postel under Settings → API & MCP; it acts for the workspace it was made in.

In: header

Try it

Authorization

Responses

`application/json`

`application/json`

`application/json`

`application/json`

List post formats

Try it

Authorization

Responses

200application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`