Pins (Formats)

Pins are the core content unit in Pindown — individual blocks you can create and update via the v1 Pins API.

See Pin Types & Schemas for the REST reference and Client SDK for @pindownai/client-js.

Supported API pin types (27)

markdown, image, gallery, table, charts, mermaid, embed, pdf-viewer, excel-viewer, stat-cards, timeline, json-viewer, json-list, links, steps, csv-viewer, user-story, chat, intro, mastra, text-media, file-upload, kanban-board, checklist, calendar, roadmap, realtime-canvas

Each type uses pin_type + pin_config on create/update. See Pin Types & Schemas for every type’s config shape. Example:

await client.pins.create({
  pin_type: 'markdown',
  pin_config: { content: '# Hello' },
  metadata: { title: 'Notes' },
})