---
title: "Publish a Notion status block"
method: POST
path: "/agency/notion-blocks"
---

# Publish a Notion status block

`POST /agency/notion-blocks`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/agency/notion-blocks`
- Auth: HTTP bearer

Renders an agency status visual (client content pipeline, approval queue, or client interview progress) from BAMF data and refreshes it in place as an HTML block in a Notion page. Never publishes posts. Agency staff only: platform admin or owner/admin/manager of the workspace. dry_run returns the HTML and never calls Notion. Requires client_approvals:write (client_approvals:read for dry_run).

## Request body

- object
  - `kind` 'pipeline' | 'approval_queue' | 'interview_progress', required
  - `workspace_id` string, uuid, required
  - `notion_page_id` string
  - `block_id` string
  - `dry_run` boolean

## Response `200`

Block refreshed, or dry-run HTML

- GenericDataResponse
  - `data` unknown

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)