> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Account API Keys > List Account API Keys Lists API key metadata for the AgentMail account: `count`, `next_page_token` and `api_keys`, each with `api_key_id`, `prefix`, `name`, `pod_id`, `inbox_id`, `used_at`, `permissions` and `created_at`. The key secret itself is never returned, only its `prefix`. 🔴 **This is the account-management surface, not a per-caller one.** Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, so the keys listed are the AIsa platform's own, not yours. Nothing in normal mail workflows needs this — use `get_agentmail_inboxes` to find inboxes and `get_agentmail_inbox_messages` to read mail. ## Example ```bash theme={null} curl -X GET "https://api.aisa.one/apis/v1/agentmail/api-keys" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## OpenAPI ````yaml openapi/agentmail.json GET /agentmail/api-keys openapi: 3.1.0 info: title: AgentMail API version: 1.0.0 description: >- AgentMail email API endpoints exposed through the AIsa unified gateway. Adapted from the upstream docs.agentmail.to OpenAPI spec. servers: - url: https://api.aisa.one/apis/v1 security: - Bearer: [] paths: /agentmail/api-keys: get: tags: - AgentMail summary: List Account API Keys description: >- Lists API key metadata for the AgentMail account: `count`, `next_page_token` and `api_keys`, each with `api_key_id`, `prefix`, `name`, `pod_id`, `inbox_id`, `used_at`, `permissions` and `created_at`. The key secret itself is never returned, only its `prefix`. 🔴 **This is the account-management surface, not a per-caller one.** Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, so the keys listed are the AIsa platform's own, not yours. Nothing in normal mail workflows needs this — use `get_agentmail_inboxes` to find inboxes and `get_agentmail_inbox_messages` to read mail. operationId: get_agentmail_api_keys parameters: - name: limit in: query required: false schema: $ref: '#/components/schemas/type__Limit' - name: page_token in: query required: false schema: $ref: '#/components/schemas/type__PageToken' - name: ascending in: query required: false schema: $ref: '#/components/schemas/type__Ascending' - name: Authorization in: header description: Bearer authentication required: true schema: type: string responses: '200': description: Response with status 200 content: application/json: schema: $ref: '#/components/schemas/type_api-keys_ListApiKeysResponse' security: - Bearer: [] components: schemas: type__Limit: type: integer description: Limit of number of items returned. title: Limit type__PageToken: type: string description: Page token for pagination. title: PageToken type__Ascending: type: boolean description: Sort in ascending temporal order. title: Ascending type_api-keys_ListApiKeysResponse: type: object properties: count: $ref: '#/components/schemas/type__Count' next_page_token: $ref: '#/components/schemas/type__PageToken' api_keys: type: array items: $ref: '#/components/schemas/type_api-keys_ApiKey' description: Ordered by `created_at` descending. required: - count - api_keys title: ListApiKeysResponse type__Count: type: integer description: Number of items returned. title: Count type_api-keys_ApiKey: type: object properties: api_key_id: $ref: '#/components/schemas/type_api-keys_ApiKeyId' prefix: $ref: '#/components/schemas/type_api-keys_Prefix' name: $ref: '#/components/schemas/type_api-keys_Name' pod_id: type: string description: >- Pod ID the api key is scoped to. If set, the key can only access resources within this pod. inbox_id: type: string description: >- Inbox ID the api key is scoped to. If set, the key can only access resources within this inbox. used_at: type: string format: date-time description: Time at which api key was last used. permissions: $ref: '#/components/schemas/type_api-keys_ApiKeyPermissions' created_at: $ref: '#/components/schemas/type_api-keys_CreatedAt' required: - api_key_id - prefix - name - created_at title: ApiKey type_api-keys_ApiKeyId: type: string description: ID of api key. title: ApiKeyId type_api-keys_Prefix: type: string description: Prefix of api key. title: Prefix type_api-keys_Name: type: string description: Name of api key. title: Name type_api-keys_ApiKeyPermissions: type: object properties: inbox_read: type: boolean description: Read inbox details. inbox_create: type: boolean description: Create new inboxes. inbox_update: type: boolean description: Update inbox settings. inbox_delete: type: boolean description: Delete inboxes. thread_read: type: boolean description: Read threads. thread_delete: type: boolean description: Delete threads. message_read: type: boolean description: Read messages. message_send: type: boolean description: Send messages. message_update: type: boolean description: Update message labels. label_spam_read: type: boolean description: Access messages labeled spam. label_blocked_read: type: boolean description: Access messages labeled blocked. label_trash_read: type: boolean description: Access messages labeled trash. draft_read: type: boolean description: Read drafts. draft_create: type: boolean description: Create drafts. draft_update: type: boolean description: Update drafts. draft_delete: type: boolean description: Delete drafts. draft_send: type: boolean description: Send drafts. webhook_read: type: boolean description: Read webhook configurations. webhook_create: type: boolean description: Create webhooks. webhook_update: type: boolean description: Update webhooks. webhook_delete: type: boolean description: Delete webhooks. domain_read: type: boolean description: Read domain details. domain_create: type: boolean description: Create domains. domain_update: type: boolean description: Update domains. domain_delete: type: boolean description: Delete domains. list_entry_read: type: boolean description: Read list entries. list_entry_create: type: boolean description: Create list entries. list_entry_delete: type: boolean description: Delete list entries. metrics_read: type: boolean description: Read metrics. api_key_read: type: boolean description: Read API keys. api_key_create: type: boolean description: Create API keys. api_key_delete: type: boolean description: Delete API keys. pod_read: type: boolean description: Read pods. pod_create: type: boolean description: Create pods. pod_delete: type: boolean description: Delete pods. description: >- Granular permissions for the API key. When ommitted all permissions are granted. Otherwise, only permissions set to true are granted. title: ApiKeyPermissions type_api-keys_CreatedAt: type: string format: date-time description: Time at which api key was created. title: CreatedAt securitySchemes: Bearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.