---
title: "Notion API notion-download-skill returns markdown for Skills without files: 2026-10-09 | Harbyn"
description: "Notion API notion-download-skill returns markdown for Skills without files, announced Oct 9, 2026."
canonical: "https://harbyn.com/changes/notion/2026-10-09-notion-download-skill-returns-markdown-for-skills-without-files"
last-updated: 2026-10-15
---

# Notion API notion-download-skill returns markdown for Skills without files

Markdown version of <https://harbyn.com/changes/notion/2026-10-09-notion-download-skill-returns-markdown-for-skills-without-files>.

Breaking change - Notion API. high severity. In effect.

When a Skill has no supporting files, notion-download-skill in Notion MCP returns the full SKILL.md text with its frontmatter instead of a URL to an archive. Skills with supporting files still return a signed URL.

## Facts

| Fact | Value |
| --- | --- |
| Vendor | [Notion API](https://harbyn.com/vendors/notion.md) |
| Kind | Breaking change |
| Severity | high |
| Status | In effect |
| Announced | Oct 9, 2026 |
| Added to Harbyn | Oct 15, 2026 |
| Lead time | No dated deadline |
| Symbols | `notion-download-skill` |
| Review | Reviewed by a person, extracted by a model |

## Find it in your code

```sh
npx harbyn scan
```

This change names no identifier the scanner can match line by line, so the scan tells you whether your repository uses Notion API, from its packages and API hosts. Nothing leaves your machine.

## Sources

Where this event comes from: the page we read, when we read it, and the hash of that snapshot.

- <https://developers.notion.com/page/changelog.md> (changelog, fetched 2026-10-15 04:48 UTC, sha256 `d00448aae5fcfae452f641c14ce02f4513239b798fd9b6ede2073508f75ddd06`)

## Related changes

### More from Notion API

- [Admin API list endpoints take start\_cursor, cursor deprecated](https://harbyn.com/changes/notion/2026-10-09-admin-api-list-endpoints-accept-start-cursor-2.md) (Deprecation, announced Oct 9, 2026)
- [Data source updates keep omitted descriptions and options](https://harbyn.com/changes/notion/2026-10-09-data-source-schema-update-fixes.md) (Behavior change, announced Oct 9, 2026)
- [notion-get-tool-access is optional](https://harbyn.com/changes/notion/2026-10-07-notion-get-tool-access-is-optional.md) (Behavior change, announced Oct 7, 2026)
- [Hosted Notion MCP sessions list one content-search tool](https://harbyn.com/changes/notion/2026-10-07-one-search-tool-in-notion-mcp.md) (Behavior change, announced Oct 7, 2026)

### Changes at other vendors

- [Amazon Selling Partner API: October listing attribute usage and enumeration value updates](https://harbyn.com/changes/amazon-sp-api/2026-10-14-sp-api-updates-new-listings-items-api-ivp-values-in-eu5-jp-and-ca-stores-oct-2.md) (effective Oct 26, 2026)
- [Supabase: four CBC-mode TLS 1.2 cipher suites will be removed from project HTTP APIs](https://harbyn.com/changes/supabase/2026-10-12-an-outdated-subset-of-tls-1-2-ciphers-will-be-disabled-on-project-http-apis.md) (effective Nov 10, 2026)
- [Google Workspace APIs: OAuth clients must be marked as agentic to call Google Workspace MCP servers](https://harbyn.com/changes/google-workspace/2026-10-12-oauth-clients-must-be-marked-as-agentic-to-call-google-workspace-mcp-servers.md) (effective Nov 11, 2026)
- [Bitbucket Cloud API: Git Credential Manager upgrade required for OAuth 2.0 Git authentication](https://harbyn.com/changes/bitbucket/2026-10-13-git-credential-manager-upgrade-required-for-oauth-2-0-git-authentication.md) (effective Nov 30, 2026)

[All upcoming deadlines](https://harbyn.com/deadlines.md)