api_keys.list() - Mesa Docs

API keys are deprecated. The SDK can manage them for CLI and direct backend integrations, but cannot use them as its own client credential. New integrations should use private keys instead.

List API keys visible to the authenticated caller. Key secret values are not returned. Required scope: admin

keys = await mesa.api_keys.list(limit=50)

for key in keys.api_keys:
    print(key.id, key.name, key.scopes)

Options

str | None

Organization override.

str | None

Opaque pagination cursor from a previous response.

int | None

Maximum number of items to return. The server maximum is 100.

Response

str | None

Cursor for the next page, or null when no more results remain.

bool

Whether another page of results is available.

list[ApiKeyListItem]

API key summaries.

ApiKeyListItem

str

API key ID.

str | None

API key name, or null when unnamed.

list[str]

Scopes granted to this key.

list[str] | None

Repository allowlist, or null when the key is not repo-scoped.

dict[str, object] | None

Additional API key metadata, or null when absent.

dict[str, str]

User-defined API key tags.

datetime | None

Last use time, or null when the key has not been used.

datetime | None

Expiration time, or null when the key does not expire.

datetime | None

Revocation time, or null when the key is active.

datetime

Creation time.

​Options

​Response

​ApiKeyListItem

Options

Response

ApiKeyListItem