Pins

Pins are the atomic content units in Pindown—typed, interactive blocks (markdown, charts, tables, timelines, checklists, and more). Every larger format is a composition of pins.

When to use pins

• One focused idea — A KPI, chart, brief, checklist, or embedded file.
• Reuse — The same pin can appear on a page, pinboard, showcase, article tab, or project tab.
• Automation — Push live data from scripts, agents, or backends via the API.

Key features

• 37 pin types — Each uses pin_type + pin_config (validated on create/update).
• Realtime updates — Changes sync to viewers in the dashboard and on share links.
• Interactive types — Checklists, comparisons, kanban pins, calendars, tables, and more support inline editing when you have permission.

Create via API

{
  "pin_type": "markdown",
  "pin_config": { "content": "# Hello" },
  "metadata": { "title": "Notes" }
}

await client.pins.create({
  pin_type: 'stat-cards',
  pin_config: {
    cards: [{ title: 'Revenue', value: '$125k', change: '+12%', trend: 'up' }],
  },
  metadata: { title: 'KPIs' },
})

IDs & routes

• ID prefix: p-…
• Dashboard: /pins
• Share: /share/pin/[pinId]

API

Reference

• Pin Types & Schemas — All 43 types, fields, and examples
• Create a Pin · Client SDK