> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # List Superagents > Returns a paginated workspace-wide Superagent inventory with owner, activity, and credit-usage metrics. Filter by visibility or search Superagents by name and creator email. ## OpenAPI ````yaml /developers/references/monitoring-api/monitoring-openapi.json get /{workspace_id}/superagents openapi: 3.1.0 info: title: Base44 Workspace Monitoring API description: |2- Workspace monitoring and analytics API. Access usage analytics, user engagement metrics, and governance data for your workspace. **Features:** - Workspace-level analytics and KPIs - User activity tracking and credit consumption - App engagement metrics and security governance **Authentication:** Required for all endpoints (admin or owner role) Use the 🔒 **Authorize** button above to enter your API key. **Rate Limits:** - Analytics endpoints: 50 requests per minute per user - User list: 50 requests per minute per user - User detail: 75 requests per minute per user - User apps: 50 requests per minute per user - User Superagents: 50 requests per minute per user - App list: 50 requests per minute per user - App analytics: 50 requests per minute per user - Superagent list: 50 requests per minute per user - Superagent analytics: 50 requests per minute per user Enterprise workspaces get 2x these limits. Rate limits are applied per authenticated user and enforced using token-bucket algorithm. version: 1.2.1 servers: - url: https://app.base44.com/api/v1/monitoring description: Monitoring API security: - ApiKeyAuth: [] tags: - name: analytics description: >- Workspace-level analytics and KPIs including usage, engagement, and cost metrics. - name: users description: User management, activity tracking, and credit consumption data. - name: apps description: App-level analytics, engagement metrics, and governance flags. - name: superagents description: Superagent inventory and analytics. paths: /{workspace_id}/superagents: get: tags: - superagents summary: List Superagents description: >- Returns a paginated workspace-wide Superagent inventory with owner, activity, and credit-usage metrics. Filter by visibility or search Superagents by name and creator email. operationId: list_superagents__workspace_id__superagents_get parameters: - name: workspace_id in: path required: true schema: type: string title: Workspace Id - name: limit in: query required: false schema: type: integer maximum: 50 minimum: 1 description: Items per page. Max 50. default: 50 title: Limit description: Items per page. Max 50. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Pagination cursor from previous response. title: Cursor description: Pagination cursor from previous response. - name: from in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Start date in `YYYY-MM-DD` format. Required if `to` is provided. Defaults to billing period start. title: From description: >- Start date in `YYYY-MM-DD` format. Required if `to` is provided. Defaults to billing period start. example: '2026-06-01' - name: to in: query required: false schema: anyOf: - type: string - type: 'null' description: >- End date in `YYYY-MM-DD` format. Required if `from` is provided. Defaults to current date. title: To description: >- End date in `YYYY-MM-DD` format. Required if `from` is provided. Defaults to current date. example: '2026-06-30' - name: sort in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Sort field. Prefix with `-` for descending. Supported fields: `"superagent_name"`, `"created_at"`, `"created_by_email"`, `"owner_user_id"`, `"active_users_last_30d"`, `"message_credits_consumed"`, `"integration_credits_consumed"`, `"total_credits_consumed"`. title: Sort description: >- Sort field. Prefix with `-` for descending. Supported fields: `"superagent_name"`, `"created_at"`, `"created_by_email"`, `"owner_user_id"`, `"active_users_last_30d"`, `"message_credits_consumed"`, `"integration_credits_consumed"`, `"total_credits_consumed"`. - name: search in: query required: false schema: anyOf: - type: string maxLength: 100 - type: 'null' description: Case-insensitive search over Superagent name and creator email. title: Search description: Case-insensitive search over Superagent name and creator email. - name: visibility in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter by Superagent visibility. Accepts `"private"`, `"workspace"`, `"public_with_login"`, `"public_without_login"`, or `"public"`. title: Visibility description: >- Filter by Superagent visibility. Accepts `"private"`, `"workspace"`, `"public_with_login"`, `"public_without_login"`, or `"public"`. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/WorkspaceSuperAgentListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: WorkspaceSuperAgentListResponse: properties: superagents: items: $ref: '#/components/schemas/WorkspaceSuperAgentListItem' type: array title: Superagents description: List of workspace Superagents. pagination: $ref: '#/components/schemas/PaginationMetadata' description: Pagination metadata. type: object required: - superagents - pagination title: WorkspaceSuperAgentListResponse description: Paginated workspace Superagent inventory. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError WorkspaceSuperAgentListItem: properties: superagent_id: type: string title: Superagent Id description: Superagent identifier. example: agent_abc123 superagent_name: type: string title: Superagent Name description: Superagent name. example: Support Agent owner_user_id: anyOf: - type: string - type: 'null' title: Owner User Id description: Current Superagent owner user ID when known. example: user_abc123 created_by_email: anyOf: - type: string - type: 'null' title: Created By Email description: Email of the user who originally created the Superagent. example: jane.doe@company.com created_at: anyOf: - type: string - type: 'null' title: Created At description: Superagent creation date in `YYYY-MM-DDTHH:MM:SSZ` format. example: '2025-01-10T14:30:00Z' active_users_last_30d: type: integer minimum: 0 title: Active Users Last 30D description: >- Approximate number of distinct users who sent messages to this Superagent in the last 30 days. Users who cannot be individually identified, such as users messaging through external channels, are counted as one user per conversation. example: 89 message_credits_consumed: type: number minimum: 0 title: Message Credits Consumed description: Message credits consumed by this Superagent in the requested period. example: 4250 integration_credits_consumed: type: number minimum: 0 title: Integration Credits Consumed description: >- Integration credits consumed by this Superagent in the requested period. example: 875 total_credits_consumed: type: number minimum: 0 title: Total Credits Consumed description: >- Combined message and integration credits consumed by this Superagent in the requested period. example: 5125 type: object required: - superagent_id - superagent_name - active_users_last_30d - message_credits_consumed - integration_credits_consumed - total_credits_consumed title: WorkspaceSuperAgentListItem description: Workspace Superagent inventory row. PaginationMetadata: properties: total: type: integer title: Total description: Total number of items. example: 156 limit: type: integer title: Limit description: Number of items per page. example: 50 next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: >- Cursor for fetching the next page. The value is `null` if there are no more pages. example: eyJsYXN0X2lkIjoiMTIzIn0= has_more: type: boolean title: Has More description: Whether there are more items to fetch. example: true type: object required: - total - limit - has_more title: PaginationMetadata description: Metadata for paginated responses ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: api_key description: >- API key for authentication. See the Authentication page for your API for details on how to get your key. ````