Feishu Bitable API

https://open.feishu.cn/document/server-docs/docs/bitable-v1/
Admin
Feishu Bitable API provides server-side interfaces for developers to programmatically interact with...
Tokens:73,716
Snippets:243
Trust Score:10
Update:3 days ago
Show doc for...
Tokens:
Raw
### cURL request to get a view

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/get

Use this cURL command to call the Get view API. It requires a valid tenant access token in the Authorization header. The URL includes the app_token, table_id, and view_id path parameters.

```bash
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/bascnCMII2ORej2RItqpZZUNMIe/tables/tblsRc9GRRXKqhvW/views/vewTpR1urY' \
-H 'Authorization: Bearer t-7f1b******8e560'
```

--------------------------------

### cURL request to list all tables

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/list

Use this cURL command to list all tables under a Bitable app. It requires an app_token and an access token. The example includes page_size and page_token query parameters.

```bash
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh/tables?page_size=10&page_token=tblsRc9GRRXKqhvW' \
-H 'Authorization: Bearer t-7f1b******8e560'
```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token/tables

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/list

Retrieves all tables under a specified Bitable app. Supports pagination via page_token and page_size parameters.

```APIDOC
## GET /open-apis/bitable/v1/apps/:app_token/tables

### Description
Retrieves all tables under a specified Bitable app. Supports pagination via page_token and page_size parameters.

### Method
GET

### Endpoint
https://open.feishu.cn/open-apis/bitable/v1/apps/:app_token/tables

### Parameters
#### Path Parameters
- **app_token** (string) - Required - Base unique device identifier. Example: "appbcbWCzen6D8dezhoCH2RpMAh"

#### Query Parameters
- **page_token** (string) - Optional - Page identifier. Not filled in the first request, indicating traversal from the beginning; when there will be more groups, the new page_token will be returned at the same time, and the next traversal can use the page_token to get more groups. Example: "tblsRc9GRRXKqhvW"
- **page_size** (int) - Optional - Paging size. Default value: 20. Maximum value: 100. Example: 10

#### Request Header
- **Authorization** (string) - Required - Access token for authentication. Format: "Bearer <access_token>". Supported token types: tenant_access_token, user_access_token. Example: "Bearer t-g1044qeGEDXTB6NDJOGV4JQCYDGHRBARFTGT1234"
- **Content-Type** (string) - Required - Fixed value: "application/json; charset=utf-8"

### Request Example
```
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh/tables?page_size=10&page_token=tblsRc9GRRXKqhvW' \
-H 'Authorization: Bearer t-7f1b******8e560'
```

### Response
#### Success Response (200)
The response body contains a list of tables and pagination information. The exact fields are not specified in the source.

#### Response Example
Not provided in the source.

### Error Handling
Error codes are not detailed in the source.
```

--------------------------------

### cURL Request to Get App Info

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/get

Sends a GET request to the Bitable API to retrieve app information. Requires an Authorization header with a Bearer token and the app_token in the URL path.

```bash
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh' \
-H 'Authorization: Bearer t-7f1b******8e560'
```

--------------------------------

### Batch Create Tables - Response

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/batch_create

Describes the response body structure and example for the batch create tables API endpoint.

```APIDOC
## 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": {
        "table_ids": [
            "tblIovTTN2eIW2hn"
        ]
    }
}
```

### Error code

| HTTP status code | Error code | Description | Troubleshooting suggestions |
| --- | --- | --- | --- |
| 200 | 1254000 | WrongRequestJson | Request error |
| 200 | 1254001 | WrongRequestBody | Request body error |
| 200 | 1254002 | Fail | Internal error, have any questions can be consulting service |
| 200 | 1254003 | WrongBaseToken | AppToken error |
| 200 | 1254004 | WrongTableId | Table id wrong |
| 200 | 1254005 | WrongViewId | View id wrong |
| 200 | 1254006 | WrongRecordId | Record id wrong |
| 200 | 1254007 | EmptyValue | Empty value |
| 200 | 1254008 | EmptyView | Empty view |
| 200 | 1254009 | WrongFieldId | Wrong fieldId |
| 200 | 1254010 | ReqConvError | Request error |
| 400 | 1254013 | TableNameDuplicated | TableNameDuplicated |
| 200 | 1254030 | TooLargeResponse | TooLargeResponse |
| 400 | 1254036 | Base is copying, please try again later. | Base copy replicating, try again later |
| 200 | 1254040 | BaseTokenNotFound | AppToken not found |
| 200 | 1254041 | TableIdNotFound | Table not found |
| 200 | 1254042 | ViewIdNotFound | View not found |
| 200 | 1254043 | RecordIdNotFound | RecordIdNotFound |
| 200 | 1254044 | FieldIdNotFound | FieldIdNotFound |
| 200 | 1254060 | TextFieldConvFail | TextFieldConvFail |
| 200 | 1254061 | NumberFieldConvFail | NumberFieldConvFail |
| 200 | 1254062 | SingleSelectFieldConvFail | SingleSelectFieldConvFail |
| 200 | 1254063 | MultiSelectFieldConvFail | MultiSelectFieldConvFail |
| 200 | 1254064 | DatetimeFieldConvFail | DatetimeFieldConvFail |
| 200 | 1254065 | CheckboxFieldConvFail | CheckboxFieldConvFail |
| 200 | 1254066 | UserFieldConvFail | The value corresponding to the personnel field type is incorrect. The possible reasons are:
- The ID type specified by the user_id_type parameter does not match the type of the provided ID.
- An unrecognized type or structure was provided. Currently, only `id` is supported, and it must be passed as an array.
- An `open_id` was passed across applications. If you are passing an ID across applications, it is recommended to use `user_id`. The `open_id` obtained from different applications cannot be used interchangeably.
 |
| 200 | 1254067 | LinkFieldConvFail | LinkFieldConvFail |
| 200 | 1254100 | TableExceedLimit | TableExceedLimit, limited to 150 |
| 200 | 1254101 | ViewExceedLimit | ViewExceedLimit, limited to 200 |
| 200 | 1254102 | FileExceedLimit | FileExceedLimit |
| 200 | 1254103 | RecordExceedLimit | RecordExceedLimit, limited to 20,000 |
| 200 | 1254104 | RecordAddOnceExceedLimit | RecordAddOnceExceedLimit, limited to 500 |
| 200 | 1254130 | TooLargeCell | TooLargeCell |
| 200 | 1254290 | TooManyRequest | Request too fast, try again later |
| 200 | 1254291 | Write conflict | The same data table does not support concurrent calls to the write interface, please check whether there is a concurrent call to the write interface. The writing interface includes: adding, modifying, and deleting records; adding, modifying, and deleting fields; modifying forms; modifying views, etc. |
| 200 | 1254301 | OperationTypeError | Base does not have advanced permissions enabled or does not support enabling advanced permissions |
| 403 | 1254302 | The role has no permissions. | The role has no permissions. |
| 200 | 1255001 | InternalError | Internal error, have any questions can be consulting service |
| 200 | 1255002 | RpcError | Internal error, have any questions can be consulting service |
| 200 | 1255003 | MarshalError | Serialization failed, have any questions can be consulting service |
| 200 | 1255004 | UmMarshalError | Deserialization failed, have any questions can be consulting service |
| 200 | 1255005 | ConvError | Internal error, have any questions can be consulting service |
| 504 | 1255040 | Request timed out, please try again later | Try again |
```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token/roles

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview

Lists all roles in a Bitable app. Requires view, comment, edit, and manage Base permissions. Access credentials: tenant_access_token or user_access_token.

```APIDOC
## GET /open-apis/bitable/v1/apps/:app_token/roles

### Description
Lists all roles in a Bitable app.

### Method
GET

### Endpoint
/open-apis/bitable/v1/apps/:app_token/roles

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.

### Response
#### Success Response (200)
- **items** (array) - List of roles.

#### Response Example
{
  "items": [
    {
      "role_id": "string",
      "role_name": "string"
    }
  ]
}
```

--------------------------------

### cURL request to list table views

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/list

Standard cURL example for the List Table Views API. Uses GET with query parameters page_size, page_token, and user_id_type. Requires an Authorization Bearer token.

```bash
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/AppbcbWCzen6D8dezhoCH2RpMAh/tables/TblsRc9GRRXKqhvW/views?page_size=10&page_token=VIVWTpR1urY&user_id_type=open_id' \
-H 'Authorization: Bearer t-7f1b******8e560'
```

--------------------------------

### cURL request to create a Base app

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/create

Sends a POST request to the Bitable API to create a Base app with a folder token and name. Requires a Bearer access token and Content-Type application/json. The example uses a placeholder token and folder token.

```bash
curl -i -X POST 'https://open.feishu.cn/open-apis/bitable/v1/apps' \
-H 'Authorization: Bearer t-7f1b******8e560' \
-H 'Content-Type: application/json' \
-d '{
  "folder_token": "fldbco*****CIMltVc",
  "name": "test name"
}'
```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token/tables

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/list

Lists all data tables in a Bitable app. Use this endpoint to retrieve table metadata such as table IDs and names.

```APIDOC
## GET /open-apis/bitable/v1/apps/:app_token/tables

### Description
Lists all data tables in a Bitable app. Use this endpoint to retrieve table metadata such as table IDs and names.

### Method
GET

### Endpoint
/open-apis/bitable/v1/apps/:app_token/tables

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.

#### Query Parameters
- **page_size** (integer) - Optional - The number of records to return per page.
- **page_token** (string) - Optional - The pagination token for the next page.

### Request Example
```
GET /open-apis/bitable/v1/apps/:app_token/tables?page_size=10&page_token=xxx
```

### Response
#### Success Response (200)
- **items** (array) - List of table objects.
- **page_token** (string) - Pagination token for the next page.
- **has_more** (boolean) - Whether there are more records.

#### Response Example
```json
{
  "items": [
    {
      "table_id": "tblxxxx",
      "name": "Table 1"
    }
  ],
  "page_token": "xxx",
  "has_more": false
}
```

```

--------------------------------

### GET /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/views

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/list

Lists all views in a specified table. Supports pagination and user ID type selection.

```APIDOC
## GET /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/views

### Description
Lists all views in a specified table. Supports pagination and user ID type selection.

### Method
GET

### Endpoint
`https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/views`

### Parameters
#### Query Parameters
- **page_size** (int) - Optional - Maximum value: `100`. Example value: `10`.
- **page_token** (string) - Optional - Page identifier. Not filled in the first request, indicating traversal from the beginning; when there will be more groups, the new page_token will be returned at the same time, and the next traversal can use the page_token to get more groups. Example value: `"VIVWTpR1urY"`.
- **user_id_type** (string) - Optional - User ID categories. Optional values: `open_id`, `union_id`, `user_id`. Default value: `open_id`. When the value is `user_id`, the following field scopes are required: Obtain user ID, Only custom apps. Example value: `"open_id"`.

### Request Example
```
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/AppbcbWCzen6D8dezhoCH2RpMAh/tables/TblsRc9GRRXKqhvW/views?page_size=10&page_token=VIVWTpR1urY&user_id_type=open_id' \
-H 'Authorization: Bearer t-7f1b******8e560'
```

### Response
No response schema provided in the source.

```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token/tables/:table_id/views

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/list

Lists all views in a specified Bitable table. This endpoint requires the app_token and table_id as path parameters, and supports pagination via page_size and page_token query parameters.

```APIDOC
## GET /open-apis/bitable/v1/apps/:app_token/tables/:table_id/views

### Description
Lists all views in a specified Bitable table.

### Method
GET

### Endpoint
`/open-apis/bitable/v1/apps/:app_token/tables/:table_id/views`

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.
- **table_id** (string) - Required - The ID of the table.

#### Query Parameters
- **page_size** (integer) - Optional - The number of records to return per page.
- **page_token** (string) - Optional - The pagination token for retrieving the next page.
- **user_id_type** (string) - Optional - The type of user ID to return.

### Request Example
```
GET /open-apis/bitable/v1/apps/:app_token/tables/:table_id/views?page_size=10&page_token=xxx
Authorization: Bearer {tenant_access_token}
```

### Response
#### Success Response (200)
- **items** (array) - List of view objects.
- **page_token** (string) - Pagination token for the next page.
- **has_more** (boolean) - Indicates if there are more records.

#### Response Example
```json
{
  "items": [
    {
      "view_id": "vewxxxx",
      "view_name": "Grid",
      "view_type": "grid"
    }
  ],
  "page_token": "xxx",
  "has_more": false
}
```

### Error Codes
| HTTP Status | Error Code | Error Message | Description |
|-------------|------------|---------------|-------------|
| 200 | 1254067 | LinkFieldConvFail | LinkFieldConvFail |
| 200 | 1254100 | TableExceedLimit | TableExceedLimit, limited to 300 |
| 200 | 1254101 | ViewExceedLimit | ViewExceedLimit, limited to 200 |
| 200 | 1254102 | FileExceedLimit | FileExceedLimit |
| 200 | 1254103 | RecordExceedLimit | RecordExceedLimit, limited to 20,000 |
| 200 | 1254104 | RecordAddOnceExceedLimit | RecordAddOnceExceedLimit, limited to 500 |
| 200 | 1254130 | TooLargeCell | TooLargeCell |
| 200 | 1254290 | TooManyRequest | Request too fast, try again later |
| 200 | 1254291 | Write conflict | The same data table does not support concurrent calls to the write interface, please check whether there is a concurrent call to the write interface. The writing interface includes: adding, modifying, and deleting records; adding, modifying, and deleting fields; modifying forms; modifying views, etc. |
| 200 | 1254301 | OperationTypeError | Base does not have advanced permissions enabled or does not support enabling advanced permissions |
| 403 | 1254302 | Permission denied. | No access rights, usually caused by the table opening of advanced permissions, please add a group containing applications in the advanced permissions settings and give this group read and write permissions |
| 200 | 1255001 | InternalError | Internal error, have any questions can be consulting service |
| 200 | 1255002 | RpcError | Internal error, have any questions can be consulting service |
| 200 | 1255003 | MarshalError | Serialization failed, have any questions can be consulting service |
| 200 | 1255004 | UmMarshalError | Deserialization failed, have any questions can be consulting service |
| 200 | 1255005 | ConvError | Internal error, have any questions can be consulting service |
| 504 | 1255040 | Request timed out, please try again later | Try again |
| 400 | 1254607 | Data not ready, please try again later | There are usually two situations when this error occurs: 1. The last submitted modification has not been processed; 2. The data is too large and the server calculation times out;This error code can be appropriately retried. |
```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token/tables/:table_id/fields

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview

Lists fields in a Bitable table. Requires view, comment, and export Base permission, or view, comment, edit and manage Base permission. Access credentials: tenant_access_token or user_access_token.

```APIDOC
## GET /open-apis/bitable/v1/apps/:app_token/tables/:table_id/fields

### Description
Lists fields in a Bitable table.

### Method
GET

### Endpoint
/open-apis/bitable/v1/apps/:app_token/tables/:table_id/fields

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.
- **table_id** (string) - Required - The ID of the table.

### Response
#### Success Response (200)
- **items** (array) - List of field objects.

#### Response Example
{
  "items": []
}
```

--------------------------------

### cURL request to batch create tables

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/batch_create

Sends a POST request to the batch_create endpoint with a JSON body containing a tables array. Requires a Bearer access token and Content-Type application/json. The example uses user_id_type=open_id and creates a table named 'table name'.

```bash
curl -i -X POST 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh/tables/batch_create?user_id_type=open_id' \
-H 'Authorization: Bearer t-7f1b******8e560' \
-H 'Content-Type: application/json' \
-d '{
  "tables": [
    {
      "name": "table name"
    }
  ]
}'
```

--------------------------------

### POST /open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/batch_create

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview

Creates multiple records in a Bitable table. Requires view, comment, edit and manage Base permission. Access credentials: tenant_access_token or user_access_token.

```APIDOC
## POST /open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/batch_create

### Description
Creates multiple records in a Bitable table.

### Method
POST

### Endpoint
/open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/batch_create

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.
- **table_id** (string) - Required - The ID of the table.

#### Request Body
- **records** (array) - Required - List of record objects.

### Request Example
{
  "records": []
}

### Response
#### Success Response (200)
- **records** (array) - List of created record objects.

#### Response Example
{
  "records": []
}
```

--------------------------------

### POST /open-apis/bitable/v1/apps

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/create

Creates a Base app in a user-defined folder. The request body can specify the app name, folder token, and time zone. The response returns the created app's token and URL.

```APIDOC
## POST /open-apis/bitable/v1/apps

### Description
Creates a Base app in a user-defined folder. The request body can specify the app name, folder token, and time zone. The response returns the created app's token and URL.

### Method
POST

### Endpoint
https://open.feishu.cn/open-apis/bitable/v1/apps

### Parameters
#### Request Header
- **Authorization** (string) - Required - Access token for authentication. Format: "Bearer `access_token`". Supported token types: tenant_access_token, user_access_token.
- **Content-Type** (string) - Required - Fixed value: "application/json; charset=utf-8"

#### Request Body
- **name** (string) - Optional - Base App Name. Example: "test name"
- **folder_token** (string) - Optional - Base App Folder Token. Default empty means root folder. Example: "fldbco*****CIMltVc"
- **time_zone** (string) - Optional - Base App Time Zone. Example: "Asia/Macau"

### Request Example
```
curl -i -X POST 'https://open.feishu.cn/open-apis/bitable/v1/apps' \
-H 'Authorization: Bearer t-7f1b******8e560' \
-H 'Content-Type: application/json' \
-d '{
  "folder_token": "fldbco*****CIMltVc",
  "name": "test name"
}'
```

### Response
#### Success Response (200)
- **code** (int) - Status code, 0 for success.
- **msg** (string) - Status message.
- **data** (object) - Response data.
  - **app** (object) - Created app information.
    - **app_token** (string) - Token of the created app.
    - **name** (string) - Name of the created app.
    - **revision** (int) - Revision number.
    - **url** (string) - URL of the created app.

#### Response Example
```
{
  "code": 0,
  "msg": "success",
  "data": {
    "app": {
      "app_token": "appbcbWCzen6D8dezOwCHd2c",
      "name": "test name",
      "revision": 1,
      "url": "https://example.feishu.cn/base/appbcbWCzen6D8dezOwCHd2c"
    }
  }
}
```

### Error Codes
- **1061001** - App name is invalid.
- **1061002** - Folder token is invalid.
- **1061003** - Time zone is invalid.
- **1061004** - App creation failed.
- **1061005** - App creation failed due to insufficient permissions.
- **1061006** - App creation failed due to rate limit.

```

--------------------------------

### POST /open-apis/bitable/v1/apps/:app_token/tables/batch_create

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview

Creates multiple tables in a Bitable app in a single request. Requires view, comment, edit and manage Base permission. Access credentials: tenant_access_token or user_access_token.

```APIDOC
## POST /open-apis/bitable/v1/apps/:app_token/tables/batch_create

### Description
Creates multiple tables in a Bitable app in a single request.

### Method
POST

### Endpoint
/open-apis/bitable/v1/apps/:app_token/tables/batch_create

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.

#### Request Body
- **tables** (array) - Required - List of table objects to create.

### Request Example
{
  "tables": [
    {
      "name": "Table 1",
      "fields": []
    },
    {
      "name": "Table 2",
      "fields": []
    }
  ]
}

### Response
#### Success Response (200)
- **tables** (array) - List of created table objects.

#### Response Example
{
  "tables": [
    {
      "table_id": "tbl1",
      "name": "Table 1"
    },
    {
      "table_id": "tbl2",
      "name": "Table 2"
    }
  ]
}
```

--------------------------------

### Delete View API - Response

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/delete

Describes the response body structure and provides an example response for the Delete View API.

```APIDOC
## 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 |
| --- | --- | --- | --- |
| 200 | 1254000 | WrongRequestJson | Request error |
| 200 | 1254001 | WrongRequestBody | Request body error |
| 200 | 1254002 | Fail | Internal error, have any questions can be consulting service |
| 200 | 1254003 | WrongBaseToken | AppToken error |
| 200 | 1254004 | WrongTableId | Table id wrong |
| 200 | 1254005 | WrongViewId | View id wrong |
| 200 | 1254006 | WrongRecordId | Record id wrong |
| 200 | 1254007 | EmptyValue | Empty value |
| 200 | 1254008 | EmptyView | Empty view |
| 200 | 1254009 | WrongFieldId | Wrong fieldId |
| 200 | 1254010 | ReqConvError | Request error |
| 200 | 1254016 | InvalidSort | invalid sort |
| 200 | 1254018 | InvalidFilter | The filter parameter is incorrect. Please refer to [Record filter development guide](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/record-filter-guide) for information on how to fill in the filter parameter. |
| 200 | 1254019 | InvalidViewType | Invalid view type |
| 200 | 1254020 | ViewNameDuplicated | Duplicate view name |
| 200 | 1254021 | EmptyViewName | View name is empty |
| 200 | 1254022 | InvalidViewName | Invalid view name |
| 200 | 1254023 | LastViewDeleteForbidden | LastViewDeleteForbidden |
| 200 | 1254030 | TooLargeResponse | TooLargeResponse |
| 400 | 1254036 | Base is copying, please try again later. | Base copy replicating, try again later |
| 200 | 1254040 | BaseTokenNotFound | AppToken not found |
| 200 | 1254041 | TableIdNotFound | Table not found |
| 200 | 1254042 | ViewIdNotFound | View not found |
| 200 | 1254043 | RecordIdNotFound | RecordIdNotFound |
| 200 | 1254044 | FieldIdNotFound | FieldIdNotFound |
| 200 | 1254045 | FieldNameNotFound | Field name does not exist |
| 200 | 1254060 | TextFieldConvFail | TextFieldConvFail |
| 200 | 1254061 | NumberFieldConvFail | NumberFieldConvFail |
| 200 | 1254062 | SingleSelectFieldConvFail | SingleSelectFieldConvFail |
| 200 | 1254063 | MultiSelectFieldConvFail | MultiSelectFieldConvFail |
| 200 | 1254064 | DatetimeFieldConvFail | DatetimeFieldConvFail |
| 200 | 1254065 | CheckboxFieldConvFail | CheckboxFieldConvFail |
| 200 | 1254066 | UserFieldConvFail | The value corresponding to the personnel field type is incorrect. The possible reasons are:
- The ID type specified by the user_id_type parameter does not match the type of the provided ID.
- An unrecognized type or structure was provided. Currently, only `id` is supported, and it must be passed as an array.
- An `open_id` was passed across applications. If you are passing an ID across applications, it is recommended to use `user_id`. The `open_id` obtained from different applications cannot be used interchangeably. |
```

--------------------------------

### POST /open-apis/bitable/v1/apps/:app_token/copy

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/copy

Copies a base app to a specified folder with optional content and time zone settings. Requires appropriate access tokens and scopes.

```APIDOC
## POST /open-apis/bitable/v1/apps/:app_token/copy

### Description
Copies a base app, allowing you to specify the destination folder and whether to copy content.

### Method
POST

### Endpoint
https://open.feishu.cn/open-apis/bitable/v1/apps/:app_token/copy

### Parameters
#### Path Parameters
- **app_token** (string) - Required - Base App Token. Example: "S404b*****e9PQsYDWYcNryFn0g"

#### Request Body
- **name** (string) - Optional - Base App Name. Example: "test name"
- **folder_token** (string) - Optional - Base App Folder Token. Example: "fldbco*****CIMltVc"
- **without_content** (boolean) - Optional - Whether to copy the Base content. true: not copy, false: copy. Example: false
- **time_zone** (string) - Optional - Base App Time Zone. Example: "Asia/Shanghai"

### Request Example
```
curl -i -X POST 'https://open.feishu.cn/open-apis/bitable/v1/apps/S404b*****e9PQsYDWYcNryFn0g/copy' \
  -H 'Authorization: Bearer t-7f1b******8e560' \
  -H 'Content-Type: application/json' \
  -d '{
    "folder_token": "fldbco*****CIMltVc",
    "name": "test name",
    "time_zone": "Asia/Shanghai",
    "without_content": false
  }'
```

### Response
#### Success Response (200)
No response body details are provided in the source.

### Error Code
No error codes are provided in the source.
```

--------------------------------

### POST /open-apis/bitable/v1/apps

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/create

Creates a new Bitable app. This endpoint requires authentication via a tenant access token or user access token.

```APIDOC
## POST /open-apis/bitable/v1/apps

### Description
Creates a new Bitable app.

### Method
POST

### Endpoint
/open-apis/bitable/v1/apps

### Parameters
#### Request Header
- **Authorization** (string) - Required - Bearer token. Use `tenant_access_token` or `user_access_token`.

#### Request Body
- **name** (string) - Required - The name of the app.

### Request Example
```json
{
  "name": "My App"
}
```

### Response
#### Success Response (200)
- **app** (object) - The created app object.
  - **app_token** (string) - The token of the created app.
  - **name** (string) - The name of the created app.

#### Response Example
```json
{
  "app": {
    "app_token": "app_token_value",
    "name": "My App"
  }
}
```

### Error Code
Refer to the error code documentation for possible error responses.
```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview

Updates information about a specific Bitable app (Base). This endpoint requires appropriate permissions and access credentials.

```APIDOC
## GET /open-apis/bitable/v1/apps/:app_token

### Description
Updates information about a specific Bitable app (Base).

### Method
GET

### Endpoint
/open-apis/bitable/v1/apps/:app_token

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The unique identifier of the Bitable app.

### Response
#### Success Response (200)
- **app** (object) - The updated app information.

#### Response Example
{
  "app": {
    "app_token": "string",
    "name": "string"
  }
}
```

--------------------------------

### POST /open-apis/bitable/v1/apps/:app_token/tables

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/create

Creates a new table in the specified Bitable app. Requires the app_token path parameter and a request body containing the table name and optional fields.

```APIDOC
## [POST] /open-apis/bitable/v1/apps/:app_token/tables

### Description
Creates a new table in the specified Bitable app.

### Method
POST

### Endpoint
/open-apis/bitable/v1/apps/:app_token/tables

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.

#### Request Body
- **table** (object) - Required - The table information.
  - **name** (string) - Required - The name of the table.
  - **fields** (array) - Optional - The fields of the table.

### Request Example
{
  "table": {
    "name": "table1",
    "fields": [
      {
        "field_name": "field1",
        "type": 1
      }
    ]
  }
}

### Response
#### Success Response (200)
- **data** (object) - The response data.
  - **table_id** (string) - The ID of the created table.

#### Response Example
{
  "data": {
    "table_id": "tbl123"
  }
}
```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/get

Retrieves information about a Bitable app using its app_token. Requires authentication via an access token and appropriate scopes.

```APIDOC
## GET /open-apis/bitable/v1/apps/:app_token

### Description
Get App information through app_token.

### Method
GET

### Endpoint
https://open.feishu.cn/open-apis/bitable/v1/apps/:app_token

### Parameters
#### Path Parameters
- **app_token** (string) - Required - Base unique device identifier. Example value: "appbcbWCzen6D8dezhoCH2RpMAh"

#### Request Header
- **Authorization** (string) - Required - Bearer access_token. Supported token types: tenant_access_token, user_access_token. Example: "Bearer t-g1044qeGEDXTB6NDJOGV4JQCYDGHRBARFTGT1234"
- **Content-Type** (string) - Required - Fixed value: "application/json; charset=utf-8"

### Request Example
```
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh' \
-H 'Authorization: Bearer t-7f1b********8e560'
```

### Response
#### Success Response
Response body and example not provided in the source.

### Error Code
Error codes not provided in the source.
```

--------------------------------

### cURL request to create a table

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/create

Use this cURL command to create a table in a Base. It requires a valid access token (tenant or user) with edit permissions. The request body specifies the table name, default view name, and fields. The response will be an HTTP 200 with the created table details.

```bash
curl -i -X POST 'https://open.feishu.cn/open-apis/bitable/v1/apps/appbcbWCzen6D8dezhoCH2RpMAh/tables' \
-H 'Authorization: Bearer t-7f1b******8e560' \
-H 'Content-Type: application/json' \
-d '{
  "table": {
    "default_view_name": "Grid",
    "fields": [
      {
        "field_name": "Text",
        "type": 1
      }
    ],
    "name": "table name"
  }
}'
```

--------------------------------

### POST /open-apis/bitable/v1/apps/:app_token/tables/:table_id/views

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/create

Creates a new view in a Bitable table. Requires app_token and table_id as path parameters. The request body should contain the view configuration. Returns the created view details.

```APIDOC
## POST /open-apis/bitable/v1/apps/:app_token/tables/:table_id/views

### Description
Creates a new view in a Bitable table. This endpoint allows you to add a view to a specified table within a Bitable app.

### Method
POST

### Endpoint
/open-apis/bitable/v1/apps/:app_token/tables/:table_id/views

### Parameters
#### Path Parameters
- **app_token** (string) - Required - The token of the Bitable app.
- **table_id** (string) - Required - The ID of the table where the view will be created.

#### Request Body
- **view_name** (string) - Required - The name of the new view.
- **view_type** (string) - Required - The type of the view (e.g., grid, kanban, etc.).
- **filter_info** (object) - Optional - Filter conditions for the view.
- **sort_info** (object) - Optional - Sorting configuration for the view.
- **field_property_info** (object) - Optional - Field property settings for the view.

### Request Example
{
  "view_name": "My New View",
  "view_type": "grid",
  "filter_info": {
    "conjunction": "and",
    "conditions": []
  },
  "sort_info": {
    "conditions": []
  },
  "field_property_info": {
    "hidden_fields": [],
    "column_width": {}
  }
}

### Response
#### Success Response (200)
- **view_id** (string) - The ID of the created view.
- **view_name** (string) - The name of the created view.
- **view_type** (string) - The type of the created view.

#### Response Example
{
  "view_id": "vew1234567890",
  "view_name": "My New View",
  "view_type": "grid"
}

### Error Codes
| HTTP Status | Error Code | Error Message | Description |
|-------------|------------|---------------|-------------|
| 200 | 1254067 | LinkFieldConvFail | LinkFieldConvFail |
| 200 | 1254100 | TableExceedLimit | TableExceedLimit, limited to 300 |
| 200 | 1254101 | ViewExceedLimit | ViewExceedLimit, limited to 200 |
| 200 | 1254102 | FileExceedLimit | FileExceedLimit |
| 200 | 1254103 | RecordExceedLimit | RecordExceedLimit, limited to 20,000 |
| 200 | 1254104 | RecordAddOnceExceedLimit | RecordAddOnceExceedLimit, limited to 500 |
| 200 | 1254130 | TooLargeCell | TooLargeCell |
| 200 | 1254290 | TooManyRequest | Request too fast, try again later |
| 200 | 1254291 | Write conflict | The same data table does not support concurrent calls to the write interface, please check whether there is a concurrent call to the write interface. The writing interface includes: adding, modifying, and deleting records; adding, modifying, and deleting fields; modifying forms; modifying views, etc. |
| 200 | 1254301 | OperationTypeError | Base does not have advanced permissions enabled or does not support enabling advanced permissions |
| 403 | 1254302 | RolePermNotAllow | The role has no permissions. |
| 403 | 1254304 | PermNotAllow | The role has no permissions. |
| 403 | 1254306 | The tenant or base owner is subject to base plan limits. | The number of resources subscribed by the tenant or base administrator reaches the limit, please contact the tenant or base administrator to upgrade the version |
| 200 | 1255001 | InternalError | Internal error, have any questions can be consulting service |
| 200 | 1255002 | RpcError | Internal error, have any questions can be consulting service |
| 200 | 1255003 | MarshalError | Serialization failed, have any questions can be consulting service |
| 200 | 1255004 | UmMarshalError | Deserialization failed, have any questions can be consulting service |
| 200 | 1255005 | ConvError | Internal error, have any questions can be consulting service |
| 504 | 1255040 | Request timed out, please try again later | Try again |
| 400 | 1254607 | Data not ready, please try again later | There are usually two situations when this error occurs: 1. The last submitted modification has not been processed; 2. The data is too large and the server calculation times out;This error code can be appropriately retried. |
| 403 | 1254608 | ReqRecommited | Same API requests are submitted repeatedly. |
```

--------------------------------

### GET /open-apis/bitable/v1/apps/:app_token/tables/:table_id/views/:view_id

Source: https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/get

Retrieves an existing view based on the provided view_id. Requires authentication with a tenant or user access token.

```APIDOC
## [GET] /open-apis/bitable/v1/apps/:app_token/tables/:table_id/views/:view_id

### Description
This interface gets existing views based on view_id.

### Method
GET

### Endpoint
https://open.feishu.cn/open-apis/bitable/v1/apps/:app_token/tables/:table_id/views/:view_id

### Parameters
#### Path Parameters
- **app_token** (string) - Required - Base app token. Example: "bascnCMII2ORej2RItqpZZUNMIe". Minimum length: 1 character.
- **table_id** (string) - Required - Table ID. Example: "tblsRc9GRRXKqhvW".
- **view_id** (string) - Required - View ID. Example: "vewTpR1urY".

#### Request Header
- **Authorization** (string) - Required - Bearer token. Supported options: tenant_access_token, user_access_token. Example: "Bearer t-g1044qeGEDXTB6NDJOGV4JQCYDGHRBARFTGT1234" or "Bearer u-cjz1eKCEx289x1TXEiQJqAh5171B4gDHPq00l0GE1234".
- **Content-Type** (string) - Required - Fixed value: "application/json; charset=utf-8".

### Request Example
```
curl -i -X GET 'https://open.feishu.cn/open-apis/bitable/v1/apps/bascnCMII2ORej2RItqpZZUNMIe/tables/tblsRc9GRRXKqhvW/views/vewTpR1urY' \
-H 'Authorization: Bearer t-7f1b******8e560'
```

### Response
#### Success Response (200)
The response body is not provided in the source documentation.

#### Response Example
Not provided in the source documentation.

### Error Code
Not provided in the source documentation.

```
Tokens:
Raw