# 更新埋点事件

{% hint style="warning" %}
灰度功能 ，如需体验试用，请联系客户经理 。
{% endhint %}

## URL

`https://www.growingio.com/v1/api/projects/{project_uid}/dim/events/{event_id}`

## 请求类型

PUT

## 请求头参数

公共头部请参考[公共请求头参数](https://growingio.gitbook.io/v3/developer-manual/api-reference/authenticate)。

## 请求参数与示例

{% tabs %}
{% tab title="请求参数" %}

| 路径参数         | 类型     | 是否必传 | 说明      |
| ------------ | ------ | ---- | ------- |
| project\_uid | string | 是    | 项目UID。  |
| event\_id    | string | 是    | 埋点事件ID。 |

| body参数 | 类型 | 是否必传 | 说明 |
| ------ | -- | ---- | -- |

| name | string | 是 | 事件名称，最大长度为30字符 |
| ---- | ------ | - | -------------- |

| type | string | 是 | <p>事件类型。</p><ul><li>counter：计数器</li></ul> |
| ---- | ------ | - | ----------------------------------------- |

| key | string | 是 | 事件标识符，只允许以字母或下划线开头，包含下划线、字母和数字的字符串，最大长度是50. |
| --- | ------ | - | ------------------------------------------- |

| description | string | 否 | 事件描述。 |
| ----------- | ------ | - | ----- |

| attrs | array | 否 | 事件关联的维度属性。 |
| ----- | ----- | - | ---------- |

| 名称           | 类型    | 是否必传 | 说明         |
| ------------ | ----- | ---- | ---------- |
| id           | Sring | 是    | 事件级变量的UID。 |
| {% endtab %} |       |      |            |

{% tab title="请求示例" %}

```
[
    {
        "key": "test",
        "name": "test_这是更新后的名字",
        "description": "这是更新后的事件描述。。",
        "type": "counter",
        "attrs": [
            {
                "id": "RbDnyqNG"
            },{
                "id": "RexMqYbL"
            }
        ]
    }
]
```

{% endtab %}

{% tab title="响应示例" %}
200：OK
{% endtab %}
{% endtabs %}

* event\_id（埋点事件ID）可通过[获取埋点事件列表](https://growingio.gitbook.io/v3/developer-manual/api-reference/project-manage/getevent)获取
* id（事件级变量ID）可通过[获取事件级变量](https://growingio.gitbook.io/v3/developer-manual/api-reference/project-manage/get-cstm)获取