**版本：202601**

# 更新元字段定义

**PUT** `/openapi/2026-01/metafield_definition/:id`

通过元字段定义 ID 更新现有元字段定义的详细信息。

## 请求

**Path参数**

- `id` uint64 (required)

  待更新的元字段定义 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `description` string

  更新后的元字段定义描述
- `name` string

  更新后的元字段定义名称

```json
{
  "description": "string",
  "name": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `metafield_definition` object

    已更新的元字段定义

    - `id` string

      元字段定义 ID
    - `key` string

      元字段键名
    - `name` string

      元字段定义名称
    - `namespace` string

      命名空间
    - `owner_resource` string

      所属资源类型：

      *   `shop`: 店铺
      *   `product`: 商品
      *   `product_image`: 商品图片
      *   `product_variant`: 商品款式
      *   `order`: 订单
      *   `page`: 自定义页面
      *   `customer`: 顾客
      *   `collection`: 商品专辑
      *   `blog`: 博客
      *   `article`: 文章
      *   `app`: 应用
    - `type` string

      元字段值类型：

      *   `date`: 日期
      *   `date_time`: 日期和时间
      *   `weight`: 重量
      *   `volume`: 体积
      *   `dimension`: 外形尺寸
      *   `integer`: 整数
      *   `number_decimal`: 小数
      *   `file_reference`: 文件引用
      *   `single_line_text_field`: 单行文本
      *   `multi_line_text_field`: 多行文本
      *   `json`: JSON
      *   `color`: 颜色
      *   `rating`: 评分
      *   `url`: URL
      *   `boolean`: 布尔值（true 或 false）
      *   `string`: 字符串
    - `description` string

      元字段定义描述
    - `create_at` string

      创建时间（ISO-8601 格式）
    - `updated_at` string

      最后更新时间（ISO-8601 格式）

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "metafield_definition": {
      "id": "string",
      "key": "string",
      "name": "string",
      "namespace": "string",
      "owner_resource": "string",
      "type": "string",
      "description": "string",
      "create_at": "string",
      "updated_at": "string"
    }
  }
}
```