# Update BlockEntity

Developers can update data stored in BlockEntity through this interface and push it to the end in real time

## Request

Facts | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/block/v2/entities/:block_id
HTTP Method | PUT
Supported app types | Custom App、Store App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.** | 变更BlockEntity内容(block:entity)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[Learn more about obtaining and using access_token.](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | Yes | **Fixed value**: "application/json; charset=utf-8"

### Path parameters

Parameter | Type | Description
---|---|---
block_id | string | block id(unique)<br>**Example value**: "7794641623571830467"

### Request body

Parameter | Type | Required | Description
---|---|---|---
title | string | No | title<br>**Example value**: "read block"
block_type_id | string | Yes | block type<br>**Example value**: "blk_6204893fee000013739f5359"
source_data | string | Yes | source data<br>**Example value**: "{"data":"biz data"}"
source_meta | string | Yes | source meta<br>**Example value**: "{"bizId":"7094067849152430100"}"
version | string | Yes | version<br>**Example value**: "1651716489253602"
source_link | string | No | source link<br>**Example value**: "{}"
summary | string | No | summary<br>**Example value**: "{"va": "this is a block"}"
preview | string | No | preview<br>**Example value**: "{"va": "this is a block"}"
i18n_summay | string | No | i18n summary<br>**Example value**: "{"va": "this is a block"}"
i18n_preview | string | No | i18n preview<br>**Example value**: "{"va": "this is a block"}"
owner | string | No | owner info<br>**Example value**: "ou_fa7aa170f92d1615de63371ac425a767"
extra | string | No | extension(json)<br>**Example value**: "{}"

### Request body example
```json
{
    "title": "read block",
    "block_type_id": "blk_6204893fee000013739f5359",
    "source_data": "{"data":"biz data"}",
    "source_meta": "{"bizId":"7094067849152430100"}",
    "version": "1651716489253602",
    "source_link": "{}",
    "summary": "{"va": "this is a block"}",
    "preview": "{"va": "this is a block"}",
    "i18n_summay": "{"va": "this is a block"}",
    "i18n_preview": "{"va": "this is a block"}",
    "owner": "ou_fa7aa170f92d1615de63371ac425a767",
    "extra": "{}"
}
```

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {

}
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
400 | 1850001 | invalid parameters | input  required parameter
500 | 1850002 | size exceeded | check block type
500 | 1850003 | no permission | apply app scope

