新しいアイテムを作成

POST

/{model}/items

• パブリックAPIエンドポイント

指定されたモデルに新しいアイテムを投稿します。作成されたアイテムは未公開（下書き）状態となり、 公開されるまではパブリック読み取りAPIには表示されません。 プロジェクトとモデルの両方で投稿が有効になっている場合のみ利用できます。 IPアドレスごとにレート制限があり、制限を超えた場合は Retry-After ヘッダーで 再試行までの待機秒数が示されます。

Authorizations

• None
• apiKey

Parameters

Path Parameters

model

required

string

モデルIDまたはキー

Request Body ^required

object

fields

フィールドキーをキーとするフィールド値。Asset、Reference、Tag、Group、 GeometryEditor、GeometryObject型のフィールドは投稿でサポートされておらず、無視されます。 モデルでこれらの型が必須フィールドとして定義されている場合、投稿自体が拒否されます。

object

Responses

202

アイテムが受理され、未公開状態で作成されました

object

id

required

作成されたアイテムの一意なID

string

$createdAt

required

アイテムが作成された日時

string format: date-time

fields

required

フィールドキーをキーとするフィールド値

object

400

JSONボディが不正、またはフィールドのバリデーションエラー

object

error

required

機械可読なエラーコード（codeと同じ内容）。

string

code

required

機械可読なエラーコード。

string

Allowed values: invalid_json validation_error posting_disabled model_posting_disabled origin_not_allowed not_found payload_too_large rate_limited access_denied unsupported_field_type

message

required

人が読めるエラーの説明。

string

details

フィールドレベルのバリデーションエラー。validation_errorの場合のみ含まれます。

Array<object>

object

field

string

code

string

message

string

403

プロジェクト/モデルで投稿が無効になっているか、オリジンが許可されていません

object

error

required

機械可読なエラーコード（codeと同じ内容）。

string

code

required

機械可読なエラーコード。

string

Allowed values: invalid_json validation_error posting_disabled model_posting_disabled origin_not_allowed not_found payload_too_large rate_limited access_denied unsupported_field_type

message

required

人が読めるエラーの説明。

string

details

フィールドレベルのバリデーションエラー。validation_errorの場合のみ含まれます。

Array<object>

object

field

string

code

string

message

string

404

モデルが見つかりません

object

error

required

機械可読なエラーコード（codeと同じ内容）。

string

code

required

機械可読なエラーコード。

string

Allowed values: invalid_json validation_error posting_disabled model_posting_disabled origin_not_allowed not_found payload_too_large rate_limited access_denied unsupported_field_type

message

required

人が読めるエラーの説明。

string

details

フィールドレベルのバリデーションエラー。validation_errorの場合のみ含まれます。

Array<object>

object

field

string

code

string

message

string

413

リクエストボディが許容サイズを超えています

object

error

required

機械可読なエラーコード（codeと同じ内容）。

string

code

required

機械可読なエラーコード。

string

Allowed values: invalid_json validation_error posting_disabled model_posting_disabled origin_not_allowed not_found payload_too_large rate_limited access_denied unsupported_field_type

message

required

人が読めるエラーの説明。

string

details

フィールドレベルのバリデーションエラー。validation_errorの場合のみ含まれます。

Array<object>

object

field

string

code

string

message

string

422

モデルに投稿でサポートされていない型の必須フィールドが含まれています

object

error

required

機械可読なエラーコード（codeと同じ内容）。

string

code

required

機械可読なエラーコード。

string

Allowed values: invalid_json validation_error posting_disabled model_posting_disabled origin_not_allowed not_found payload_too_large rate_limited access_denied unsupported_field_type

message

required

人が読めるエラーの説明。

string

details

フィールドレベルのバリデーションエラー。validation_errorの場合のみ含まれます。

Array<object>

object

field

string

code

string

message

string

429

リクエストが多すぎます。Retry-After ヘッダーが示す時間が経過してから再試行してください

object

error

required

機械可読なエラーコード（codeと同じ内容）。

string

code

required

機械可読なエラーコード。

string

Allowed values: invalid_json validation_error posting_disabled model_posting_disabled origin_not_allowed not_found payload_too_large rate_limited access_denied unsupported_field_type

message

required

人が読めるエラーの説明。

string

details

フィールドレベルのバリデーションエラー。validation_errorの場合のみ含まれます。

Array<object>

object

field

string

code

string

message

string

Headers

Retry-After

integer

再試行までの待機秒数