# List Data Knowledge Tag

List Aily's data knowledge tags
**Notice**：- `tenant_access_token` only supports channel APP identities that use smart partners to build assistants
- `user_access_token` requires the user to have developer/operations staff privileges

## Request

Facts | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/aily/v1/apps/:app_id/data_asset_tags
HTTP Method | GET
Rate Limit | [20 per second](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
Supported app types | Custom App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.** | View data and knowledge assets in Aily(aily:data_asset:read)

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>or<br>`user_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### Path parameters

Parameter | Type | Description
---|---|---
app_id | string | AppID<br>**Example value**: "spring_5862e4fea8__c"<br>**Data validation rules**:<br>- Length range: `0` ～ `255` characters

### Query parameters

Parameter | Type | Required | Description
---|---|---|---
page_size | int | No | Paging parameters: paging size, default: 20, max: 100<br>**Example value**: 10
page_token | string | No | Page identifier. It is 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<br>**Example value**: eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0=
keyword | string | No | Fuzzy matching classification name<br>**Example value**: 电影<br>**Data validation rules**:<br>- Length range: `0` ～ `255` characters
data_asset_tag_ids | string\[\] | No | Fuzzy matching classification name<br>**Example value**: spring_5862e4fea8__c__asset_tag_aadg2b5ql4gbs<br>**Data validation rules**:<br>- Length range: `0` ～ `255`

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-
items | data_asset_tag\[\] | data knowledge classification list
data_asset_tag_id | string | Data knowledge classification name
name | string | Data Knowledge Classification ID
page_token | string | Page identifier, when has_more is true, a new page_token will also be returned. Otherwise, page_token will not be returned
has_more | boolean | Whether the response body has more parameters

### Response body example
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "data_asset_tag_id": "spring_5862e4fea8__c__asset_tag_aadg2b5ql4gbs",
                "name": "电影"
            }
        ],
        "page_token": "eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0=",
        "has_more": true
    }
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
400 | 2700001 | param is invalid | Please check the request parameters in conjunction with the documentation

