> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

> プログラムでBox Notes APIを使用し、マークダウンコンテンツからBox Noteを作成します。

# Box Notes API

export const RelatedLinks = ({title, items = []}) => {
  const getBadgeClass = badge => {
    if (!badge) return "badge-default";
    const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
    return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
  };
  if (!items || items.length === 0) {
    return null;
  }
  return <div className="my-8">
      {}
      <h3 className="text-sm font-bold uppercase tracking-wider mb-4">{title}</h3>

      {}
      <div className="flex flex-col gap-3">
        {items.map((item, index) => <a key={index} href={item.href} className="py-2 px-3 rounded related_link hover:bg-[#f2f2f2] dark:hover:bg-[#111827] flex items-center gap-3 group no-underline hover:no-underline border-b-0">
            {}
            <span className={`px-2 py-1 rounded-full text-xs font-semibold uppercase tracking-wide flex-shrink-0 ${getBadgeClass(item.badge)}`}>
              {item.badge}
            </span>

            {}
            <span className="text-base">{item.label}</span>
          </a>)}
      </div>
    </div>;
};

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

Box Notes APIを使用すると、プログラムを介してマークダウンコンテンツをネイティブのBox Notes (`.boxnote`形式) に変換し、1回のAPIコールでBoxファイルシステムに直接アップロードすることができます。このAPIはマークダウンからProseMirrorへの変換、事前検証、ファイルのアップロードをバックグラウンドで処理するため、ユーザーが自分で`.boxnote`ファイルを作成する必要がなくなります。

<Note>
  現在、Box Notes APIではマークダウンコンテンツからのBox Noteの作成のみがサポートされています。メモの読み取り、更新、リスト表示、削除については、既存の<Link href="/reference/get-files-id">BoxファイルAPI</Link>を介して管理できます。今後、他の入力形式や操作が追加される可能性があります。
</Note>

## 仕組み

`POST /2.0/notes/convert`にリクエストを送信すると、APIは以下の手順を実行します。

<Steps>
  <Step title="リクエストの検証">
    このAPIはリクエスト本文を検証し、必須フィールド、コンテンツサイズの制限、および有効な`content_format`を確認します。
  </Step>

  <Step title="事前チェックの実行">
    ファイルアップロードの事前チェックでは、呼び出し元の権限、ストレージ容量の制限、ターゲットフォルダ内の名前の競合を確認します。
  </Step>

  <Step title="コンテンツの変換">
    マークダウンコンテンツは、`.boxnote`形式のBox Notes ProseMirrorドキュメントに変換されます。
  </Step>

  <Step title="ファイルのアップロード">
    結果の`.boxnote`ファイルは、指定された親フォルダにアップロードされます。
  </Step>

  <Step title="結果を返す">
    APIは、新しいファイルの`type`と`id`を含む`201 Created`を返します。
  </Step>
</Steps>

## Box Notes APIのバージョン

Box Notes APIは、Box APIバージョン`2026.0`以降で利用できます。Box Notes APIのエンドポイントに対するすべてのAPIリクエストに、`2026.0`に設定された`box-version`ヘッダーを含める必要があります。

詳細については、<Link href="/guides/api-calls/api-versioning-strategy">APIのバージョン戦略</Link>を参照してください。

## サポートされる操作

| 操作      | サポートされるかどうか | 詳細                                                                      |
| ------- | ----------- | ----------------------------------------------------------------------- |
| 作成 (変換) | はい          | `POST /2.0/notes/convert`                                               |
| 読み取り    | いいえ         | 作成後に`GET /2.0/files/{file_id}`を使用                                       |
| 更新      | いいえ         | このAPIではサポート外                                                            |
| 削除      | いいえ         | `DELETE /2.0/files/{file_id}`を使用                                        |
| リストの取得  | いいえ         | <Link href="/reference/get-folders-id-items">BoxフォルダAPI</Link>を使用してください |

## 権限

Box Notes APIは、Boxの既存のファイルアップロード権限を利用します。新しいOAuthスコープは必要ありません。認証済みのユーザーがターゲットフォルダへのファイルアップロード権限を持っている場合、このAPIを使用してメモを作成できます。

## 制限

| 制約            | 上限値                   |
| ------------- | --------------------- |
| コンテンツの最大サイズ   | 1 MB                  |
| サポートされている入力形式 | マークダウンのみ              |
| 変換に要する最大時間    | リクエストごとに最大30秒         |
| レスポンスのペイロード   | 最小限 - `type`および`id`のみ |

<Tip>
  メモの作成後にファイルの全メタデータを取得するには、返された`id`を使用して`GET /2.0/files/{file_id}`を呼び出します。
</Tip>

## 次の手順

<CardGroup cols={2}>
  <Card title="入門ガイド" icon="rocket" href={localizeLink("/guides/box-notes/get-started")}>
    認証を設定し、マークダウンから最初のBox Noteを作成します。
  </Card>

  <Card title="マークダウンをBox Noteに変換" icon="file-lines" href={localizeLink("/guides/box-notes/convert-markdown")}>
    リクエストパラメータ、エラー処理、コード例が網羅された詳細なガイド。
  </Card>

  <Card title="ユースケース" icon="lightbulb" href={localizeLink("/guides/box-notes/use-cases")}>
    AIによるメモ作成、自動レポート生成、およびサードパーティ製コンテンツのインポートに関する一般的シナリオ。
  </Card>
</CardGroup>

<RelatedLinks
  title="関連するAPI"
  items={[
{ label: translate("Convert Markdown to Box Note"), href: "/reference/v2026.0/post-notes-convert", badge: "POST" },
{ label: translate("Get file information"), href: "/reference/get-files-id", badge: "GET" },
{ label: translate("Upload file"), href: "/reference/post-files-content", badge: "POST" }
]}
/>