---
title: "Markdown heading outline"
method: POST
path: "/api/agent-commerce/v1/services/markdown_heading_outline/execute"
tags: ["data_tools"]
---

# Markdown heading outline

`POST /api/agent-commerce/v1/services/markdown_heading_outline/execute`

## Request

- Base URL: `https://www.tradepilotusa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.tradepilotusa.com/api/agent-commerce/v1/services/markdown_heading_outline/execute`
- Auth: none declared

Extract ATX headings with levels and source line numbers from Markdown, excluding fenced code blocks. Leaves inline Markdown in titles unchanged. Setext and container-nested headings are outside the supported subset.

## Request body

- object
  - `markdown` string, required

## Response `200`

Successful response

- object
  - `result` object, required
    - `syntax` string, required
    - `headings` object[], required
      - `line` integer, required
      - `level` integer, required
      - `title` string, required
    - `heading_count` integer, required
  - `utility` 'markdown_heading_outline', required
  - `provenance` object, required
    - `execution` 'deterministic_local', required
    - `model_used` unknown, required
    - `network_request_performed` unknown, required
  - `request_id` string, required

## Other responses

- `402`: Payment Required

---

[API](https://skmtc.dev/tradepilotusa/apis/tradepilotusa-agent-commerce.md) · [All operations](https://skmtc.dev/tradepilotusa/apis/tradepilotusa-agent-commerce/llms.txt) · [OpenAPI document](https://skmtc.dev/tradepilotusa/apis/tradepilotusa-agent-commerce/revisions/1060778e0a57?raw)