Prismer Notion

# Recommended
# Use a reviewed, version-pinned official installer; do not pipe remote shell into bash.

# Only after explicit installation authorization, in an approved tools directory
npm install --prefix "$PRISMER_NOTION_TOOLS_DIR" "ntn@$APPROVED_NTN_VERSION"

npm exec --prefix "$PRISMER_NOTION_TOOLS_DIR" -- ntn --version

export NOTION_API_TOKEN=$NOTION_API_KEY      # ntn reads NOTION_API_TOKEN
# Keep the configured secure keychain; do not globally disable it.

if command -v ntn >/dev/null 2>&1; then
  # use ntn
else
  # fall back to curl
fi

ntn api v1/users                                  # GET
# POST with inline body
ntn api v1/pages "parent[page_id]=abc123" \
  "properties[title][title][0][text][content]=Notes"
ntn api v1/pages/abc123 -X PATCH archived:=true   # PATCH; := is non-string (bool/num/null)

ntn api v1/search query="page title"

ntn api v1/pages/{page_id}

ntn api v1/pages/{page_id}/markdown

ntn api v1/blocks/{page_id}/children

ntn api v1/pages \
  "parent[page_id]=xxx" \
  "properties[title][title][0][text][content]=Notes from meeting" \
  markdown="# Agenda

- Q3 roadmap
- Hiring"

ntn api v1/pages/{page_id}/markdown -X PATCH --json - <<'JSON'
{"type":"insert_content","insert_content":{"content":"## Update\n\nShipped the prototype."}}
JSON

ntn api v1/data_sources/{data_source_id}/query -X POST \
  "filter[property]=Status" "filter[select][equals]=Active"

echo '{"filter": {"property": "Status", "select": {"equals": "Active"}}, "sorts": [{"property": "Date", "direction": "descending"}]}' | \
  ntn api v1/data_sources/{data_source_id}/query -X POST --json -

ntn files create < photo.png
ntn files create --external-url https://example.com/photo.png
ntn files list

curl --fail-with-body --silent --show-error -X GET "https://api.notion.com/v1/..." \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json"

curl --fail-with-body --silent --show-error -X POST "https://api.notion.com/v1/search" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{"query": "page title"}'

curl --fail-with-body --silent --show-error "https://api.notion.com/v1/pages/{page_id}" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03"

curl --fail-with-body --silent --show-error "https://api.notion.com/v1/pages/{page_id}/markdown" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03"

curl --fail-with-body --silent --show-error "https://api.notion.com/v1/blocks/{page_id}/children" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03"

curl --fail-with-body --silent --show-error -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"page_id": "xxx"},
    "properties": {"title": {"title": [{"text": {"content": "Notes from meeting"}}]}},
    "markdown": "# Agenda\n\n- Q3 roadmap\n- Hiring\n\n## Decisions\n- Ship MVP Friday"
  }'

curl --fail-with-body --silent --show-error -X PATCH "https://api.notion.com/v1/pages/{page_id}/markdown" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{"type":"insert_content","insert_content":{"content":"## Update\n\nShipped the prototype."}}'

curl --fail-with-body --silent --show-error -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"data_source_id": "xxx"},
    "properties": {
      "Name": {"title": [{"text": {"content": "New Item"}}]},
      "Status": {"select": {"name": "Todo"}}
    }
  }'

curl --fail-with-body --silent --show-error -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {"property": "Status", "select": {"equals": "Active"}},
    "sorts": [{"property": "Date", "direction": "descending"}]
  }'

curl --fail-with-body --silent --show-error -X POST "https://api.notion.com/v1/data_sources" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"database_id": "xxx"},
    "title": [{"text": {"content": "My Database"}}],
    "properties": {
      "Name": {"title": {}},
      "Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
      "Date": {"date": {}}
    }
  }'

curl --fail-with-body --silent --show-error -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{"properties": {"Status": {"select": {"name": "Done"}}}}'

curl --fail-with-body --silent --show-error -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "children": [
      {"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello from Hermes!"}}]}}
    ]
  }'

# 1. Create upload
curl --fail-with-body --silent --show-error -X POST "https://api.notion.com/v1/file_uploads" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{"filename": "photo.png", "content_type": "image/png"}'

# 2. Send multipart bytes to the created upload's /send endpoint
curl --fail-with-body --silent --show-error -X POST "https://api.notion.com/v1/file_uploads/{file_upload_id}/send" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -F "file=@photo.png;type=image/png"

# 3. Reference {file_upload_id} in a page/block payload