# 列出手動標籤

## List client tags

> Retrieve a list of all client tags with pagination

```json
{"openapi":"3.0.3","info":{"title":"Manta OpenAPI","version":"0.318.0"},"tags":[{"name":"ClientTags","description":"Client tags management and mapping"}],"servers":[{"url":"https://mantago.cc/api","description":"MantaGo Openapi host url"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token for API authentication"}},"schemas":{"SecretRequest":{"type":"object","properties":{"secret":{"type":"string","description":"Secret key for API authentication"}},"required":["secret"]},"ClientTagListResponse":{"allOf":[{"$ref":"#/components/schemas/BasicSuccessResponse"},{"type":"object","properties":{"clientTagList":{"type":"array","items":{"$ref":"#/components/schemas/ClientTag"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}]},"BasicSuccessResponse":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]},"ClientTag":{"type":"object","properties":{"id":{"type":"string","description":"Client tag unique identifier"},"name":{"type":"string","description":"Client tag name"},"botId":{"type":"string","description":"Associated bot ID"}}},"Pagination":{"type":"object","properties":{"totalPages":{"type":"integer","description":"Total number of pages"},"currentPage":{"type":"integer","description":"Current page number"},"hasPre":{"type":"boolean","description":"Whether there is a previous page"},"hasNext":{"type":"boolean","description":"Whether there is a next page"}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errResponse":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"},"botId":{"type":"string"}},"required":["message","code"]}},"required":["success","errResponse"]}},"responses":{"TokenError":{"description":"JWT token is invalid or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"PermissionError":{"description":"Permission denied - insufficient access rights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"RateLimitError":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/openapi/clientTags/list":{"post":{"tags":["ClientTags"],"summary":"List client tags","description":"Retrieve a list of all client tags with pagination","parameters":[{"name":"botId","in":"query","required":true,"schema":{"type":"string"},"description":"The bot ID for the API request"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Page number for pagination"},{"name":"perpage","in":"query","required":false,"schema":{"type":"integer","default":10},"description":"Number of items per page"},{"name":"search","in":"query","required":false,"schema":{"type":"string","default":""},"description":"Search term for filtering results"},{"name":"sorting","in":"query","required":false,"schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"},"description":"Sort order (ASC or DESC)"},{"name":"sortingType","in":"query","required":false,"schema":{"type":"string","enum":["updateAt","clientCount"],"default":"updateAt"},"description":"Field to sort by (updateAt, clientCount, createdAt, name)"},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["line","facebook","instagram","liveChat","whatsapp"]},"description":"Platform filter (line, facebook, instagram, liveChat, whatsapp)"},{"name":"startTime","in":"query","required":false,"schema":{"type":"string","default":""},"description":"Start time for date range filter"},{"name":"endTime","in":"query","required":false,"schema":{"type":"string","default":""},"description":"End time for date range filter"},{"name":"isCountByPlatform","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Whether to count by platform"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretRequest"}}}},"responses":{"200":{"description":"Client tags list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientTagListResponse"}}}},"401":{"$ref":"#/components/responses/TokenError"},"403":{"$ref":"#/components/responses/PermissionError"},"404":{"description":"OpenAPI configuration not found or client tags list retrieval failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/RateLimitError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```