1行でテキストを自由入力できるフィールドです。
文字列
"textField": "some text"入力方法によって以下のパターンがあります。
キーなし ／ null
フィールドが空値の場合のレスポンスの詳細につきまして、本ページ下部の一覧を併せてご確認ください。
複数行でテキストを自由入力できるフィールドです。プレーンテキストによる入力となります。
文字列
"textArea": "some\ntext"入力方法によって以下のパターンがあります。
キーなし ／ null
改行を含む場合、\n として出力されます。
複数行の装飾可能なテキストを自由入力できるフィールドです。
文字列（HTML形式）
"richEditor": "<p>some text</p>"入力方法によって以下のパターンがあります。
キーなし ／ null
複数行の装飾可能なテキストを自由入力できるフィールドです。
文字列（HTML形式）
"richEditorOld": "<p>some text</p>"入力方法によって以下のパターンがあります。
キーなし ／ ""
画像用のフィールドです。
オブジェクト（画像オブジェクト）
※ altは任意の設定項目のため、キー自体が含まれない場合もあります。
※ height と width は、拡張子によっては、キー自体が含まれない場合もあります。
"image": {
"url": "https://images.microcms-assets.io/assets/xxxx/yyyy/image.png.",
"height": 630,
"width": 1200,
"alt": "Some sample alt text."
}キーなし
複数の画像用のフィールドです。
配列（画像オブジェクトの配列）
"imageList": [
{
"url": "https://images.microcms-assets.io/assets/xxxx/yyyy/image1.png",
"height": 630,
"width": 1200,
"alt": "Some sample alt text."
},
{
"url": "https://images.microcms-assets.io/assets/xxxx/yyyy/image2.png",
"height": 630,
"width": 1200,
"alt": "Some sample alt text."
}
]空配列（[]）
Date型のフィールドです。
文字列（日時、ISO 8601形式のUTC（協定世界時））
"date": "2023-01-01T00:00:00.000Z"キーなし
真偽値フィールドの値はデフォルトで false となっています。
定義したリストの中から値を選択するフィールドです。
配列（事前に定義した選択肢の配列）
// 複数選択がOFFのとき
"selectField": ["Apple"]
// 複数選択がONで、複数選択しているとき
"selectField": ["Apple", "ORANGE"]空配列（[]）
他コンテンツを参照するフィールドです。
オブジェクト（他コンテンツのデータ）
"relationalContent": {
"id": "xxxxxxxxxx",
"createdAt": "2023-01-01T00:00:00.000Z",
"updatedAt": "2023-01-01T00:00:00.000Z",
"publishedAt": "2023-01-01T00:00:00.000Z",
"revisedAt": "2023-01-01T00:00:00.000Z",
"title": "some title"
}null
複数の他コンテンツを参照するフィールドです。
配列（他コンテンツのデータの配列）
"relationalContentList": [
{
"id": "xxxxxxxxxx",
"createdAt": "2023-01-01T00:00:00.000Z",
"updatedAt": "2023-01-01T00:00:00.000Z",
"publishedAt": "2023-01-01T00:00:00.000Z",
"revisedAt": "2023-01-01T00:00:00.000Z",
"title": "some title"
},
{
"id": "yyyyyyyy",
"createdAt": "2023-02-01T00:00:00.000Z",
"updatedAt": "2023-02-01T00:00:00.000Z",
"publishedAt": "2023-02-01T00:00:00.000Z",
"revisedAt": "2023-02-01T00:00:00.000Z",
"title": "some title 2"
}
]空配列（[]）
作成済みのカスタムフィールドを利用したフィールドです。
オブジェクト
"customField": {
"fieldId": "someCustomField",
// 以降、作成したカスタムフィールドの内容に準ずる
"title": "some titlte"
}入力方法によって以下のパターンがあります。null / {“fieldId”: “someFieldId”}
作成済みのカスタムフィールドを複数選択し、繰り返し入力できるフィールドです。
配列（カスタムフィールドオブジェクトの配列）
"repeatField": [
{
"fieldId": "someCustomField",
"title": "some titlte"
},
{
"fieldId": "someCustomField",
"title": "some titlte 2"
}
]入力方法によって以下のパターンがあります。
空配列（[]） / null
ファイル用のフィールドです。レスポンスに、ファイルのURLとファイルサイズ（単位はByte）が含まれます。
オブジェクト
"file": {
"url": "https://files.microcms-assets.io/assets/ｘxxxx/yyyy/files.zip",
"fileSize": 10000
}キーなし
外部データの読み込みができるフィールドです。
オブジェクト（アプリケーションから連携されたデータのオブジェクト）
"iframe": {
"id": "123"
}キーなし
拡張フィールドのレスポンスに関する詳細は、拡張フィールドの詳細ページも合わせてご参照ください。
拡張フィールドによる外部データ連携｜microCMSドキュメント
入力方法ごとに、各フィールドの値が空値だった場合のレスポンス一覧を示します。
管理画面からの入力 | CSVインポート POST／PUT API（※1） 既存APIにフィールドを追加（※2） | PATCH API | |
|---|---|---|---|
テキストフィールド | キーなし | キーなし |
|
テキストエリア | キーなし | キーなし |
|
リッチエディタ | キーなし | キーなし |
|
旧リッチエディタ（非推奨） | キーなし | キーなし |
|
画像 | キーなし | キーなし | キーなし |
複数画像 |
|
|
|
日時 | キーなし | キーなし | キーなし |
真偽値 |
|
|
|
セレクトフィールド |
|
|
|
コンテンツ参照 |
|
|
|
複数コンテンツ参照 |
|
|
|
数字 | キーなし | キーなし |
|
カスタムフィールド |
（※4） |
|
（※4） |
繰り返しフィールド |
|
|
|
ファイル | キーなし | キーなし | キーなし |
拡張フィールド | キーなし（※5） | キーなし | キーなし |
（※1）POST／PUT APIにおいて、空値で登録する方法はそれぞれ「POST /api/v1/{endpoint}」「PUT /api/v1/{endpoint}/{content_id}」をご確認ください。
（※2）すでに登録されているAPIスキーマにフィールドを追加し、既存コンテンツにリクエストした際のレスポンスです。一度、コンテンツを更新すると「管理画面からの入力」と同じレスポンスになります。
（※3）PATCH APIにおいて、空値で登録する方法は「PATCH /api/v1/{endpoint}/{content_id}」をご確認ください。
（※4）レスポンスの値はカスタムフィールドのスキーマ構造によって決定されます。
（※5）一度フィールドにデータを入力した後に、管理画面からデータを空にした場合は、キーはそのまま残り、任意の空値（"" , null , [] など）が入ります。
「キーなし」とは、レスポンスに該当フィールドのキー自体を含まない状態を指しています。