Skip to main content

List API Keys (V2)

Lists customized ACL API keys in the calling organization.

GET/v2/api-keys
Connection Endpoint

The base URL for this API is in the following format:

https://api.cloud.zilliz.com

📘Notes

The endpoints on the control plane currently supports up to 20 requests per second per user per endpoint.

shell
export BASE_URL="https://api.cloud.zilliz.com"
Parameters
Authorizationstringheaderrequired

The authentication token should be an API key with appropriate privileges.

Example Value: Bearer {{TOKEN}}
currentPageintegerquery

The page number to return. The first page is 1.

Example Value: 1
pageSizeintegerquery

The number of items to return per page.

Example Value: 10
bash
export TOKEN="YOUR_API_KEY"

curl --request GET \
--url "${BASE_URL}/v2/api-keys" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
Responses200 OK - application/json

Returns a successful result or an error message.

A successful response.

codeintegerrequired

The response code.

Example Value: 0
dataobjectrequired
countintegerrequired

The total number of matching items.

currentPageintegerrequired

The current page number.

Value Range: ≥ 1
pageSizeintegerrequired

The requested page size.

Value Range: ≥ 1
apiKeysarrayrequired

The apiKeys returned on this page.

[]apiKeysobjectrequired
apiKeyIdstringrequired

The public API key ID.

namestringrequired

The API key display name.

descriptionstring

The API key description.

creatorNamestringrequired

The resolved display name of the creator.

createdBystringrequired

The creator email address or creator API key ID.

orgRolestringrequired

The organization role assigned to the API key: Owner, Member, or Billing-Admin.

projectsarrayrequired

The project-level access granted to the API key.

[]projectsobjectrequired
projectIdstringrequired

The project ID.

projectNamestring

The project display name.

rolestringrequired

The project role: Admin, Read-Write, or Read-Only.

allClusterboolean

Whether access covers all clusters in the project.

clustersarray

The clusters the API key can access.

[]clustersobject
clusterIdstringrequired

The cluster ID.

clusterNamestringrequired

The cluster display name.

allVolumeboolean

Whether access covers all volumes in the project.

volumesarray

The volumes the API key can access.

[]volumesobject
volumeIdstringrequired

The volume ID.

volumeNamestringrequired

The volume display name.

createTimestring<date-time>required

The creation time in UTC ISO 8601 format.

A failure response.

codeintegerrequired

The response code.

messagestringrequired

The error message.

Successjson
{
    "code": 0,
    "data": {
        "count": 2,
        "currentPage": 1,
        "pageSize": 10,
        "apiKeys": [
            {
                "apiKeyId": "key-xxxxxxxxxxxxxx",
                "name": "Data Pipeline",
                "description": "API key used by the ingestion pipeline",
                "creatorName": "Alice",
                "createdBy": "alice@example.com",
                "orgRoles": [
                    {
                        "bindingId": "rb-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                        "roleId": "r-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                        "roleName": "Org Viewer",
                        "roleType": "org"
                    }
                ],
                "projectRoles": [
                    {
                        "projectId": "proj-xxxxxxxx",
                        "roles": [
                            {
                                "bindingId": "rb-yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
                                "roleId": "r-yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
                                "roleName": "Data Reader",
                                "roleType": "project"
                            }
                        ]
                    }
                ],
                "createTime": "2026-07-22T02:30:00Z"
            }
        ]
    }
}
Ctrl I