> ## Documentation Index > Fetch the complete documentation index at: https://docs.replicas.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get Analytics Overview > Returns an aggregated overview of organization activity for organization admins: a per-bucket time series of pull requests opened, merged, and closed; compute-minute usage bucketed and broken down by workspace source; workspace counts grouped by source; inference usage ranked by coding harness, model, and credential; skill and MCP call counts ranked by name; and a per-user leaderboard where each entry also carries that user's workspace counts by source and their daily compute minutes in `activity`. Replicas support accounts that joined the organization are left out of the leaderboard. Totals come twice, as `rangeTotals` for the requested range and `allTimeTotals` for the organization's whole history. ## OpenAPI ````yaml /openapi.json get /v1/analytics/overview openapi: 3.1.0 info: title: Replica API version: 2.0.0 description: >- The Replica API allows you to programmatically manage cloud workspaces for AI agents. Use this API to manage environments (the org-scoped primitive workspaces are created from — including variables, files, skills, MCPs, warm hooks, start hooks, and warm pools), create and manage replicas, send messages, manage chats, stream events, read connected repositories and repository sets, and configure automations. servers: - url: https://api.replicas.dev description: Production API security: - apiKey: [] tags: - name: Environments description: >- Manage environments — the primitive that workspaces are created from. Variables, files, skills, MCPs, warm-hooks, and warm-pools are all scoped to an environment. Every organization has a singleton Global environment whose values apply to every workspace. Personal environments are scoped to the authenticated user and can be standalone or source-backed by a team environment. - name: Repository description: >- Read repositories and repository sets connected to your organization. Repositories are the underlying GitHub-connection layer; bind them to an environment to use them in workspaces. - name: Replica description: >- Manage replicas (workspaces) for AI agents. Workspace creation with `POST /v1/replica` accepts API keys and workspace engine-secret authentication. Other Replica operations also accept logged-in user JWTs from first-party clients. - name: Terminal description: Manage interactive terminal sessions in active workspaces - name: Preview description: Manage public preview URLs for workspace ports - name: Profile description: Read and update the authenticated user's profile - name: Credentials description: >- Manage coding-agent credentials for an organization or the authenticated user - name: Preferences description: Manage organization behavior preferences - name: Slack description: Connect Slack identities and route threads to Replicas workspaces - name: Linear description: Connect Linear identities to Replicas accounts - name: Automation description: >- Create and manage automations that trigger replicas on a schedule or in response to events - name: Downloads description: Download Replicas applications - name: Media description: >- Read workspace media and obtain short-lived download or inline preview URLs - name: Analytics description: >- Read aggregated activity and usage metrics for your organization: compute minutes, workspaces created by source, and pull request throughput over a time range. - name: Presence description: >- Read and report ephemeral member presence: who is online, where they are (environment or workspace), and whether they are typing. Presence is backed by short-lived keys rather than the database and broadcast to other members over the events stream. - name: Plugins description: >- Install and manage native and Composio-backed workspace plugins. A plugin installs for a single environment, for the whole organization (which uses the Global environment), or for one member personally. A workspace uses the most specific installation available: personal, then its own environment, then the environment it was branched from, then Global. Composio Connect Links host managed OAuth, custom OAuth, API-key, bearer-token, basic, and dynamic OAuth authentication without exposing provider credentials to Replicas. paths: /v1/analytics/overview: get: tags: - Analytics summary: Get Analytics Overview description: >- Returns an aggregated overview of organization activity for organization admins: a per-bucket time series of pull requests opened, merged, and closed; compute-minute usage bucketed and broken down by workspace source; workspace counts grouped by source; inference usage ranked by coding harness, model, and credential; skill and MCP call counts ranked by name; and a per-user leaderboard where each entry also carries that user's workspace counts by source and their daily compute minutes in `activity`. Replicas support accounts that joined the organization are left out of the leaderboard. Totals come twice, as `rangeTotals` for the requested range and `allTimeTotals` for the organization's whole history. operationId: getAnalyticsOverview parameters: - name: bucket in: query required: false description: Time bucket granularity for the returned series. Defaults to `day`. schema: type: string enum: - day - week - month default: day - name: start in: query required: false description: >- Inclusive start of the range as an ISO 8601 timestamp. Defaults to 30 days before `end`. schema: type: string format: date-time - name: end in: query required: false description: >- Exclusive end of the range as an ISO 8601 timestamp. Defaults to the current time. schema: type: string format: date-time responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/AnalyticsOverview' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalServerError' components: schemas: AnalyticsOverview: type: object description: >- Aggregated activity and usage metrics for an organization over a time range properties: bucket: type: string enum: - day - week - month description: Time bucket granularity of the returned series start: type: string format: date-time description: Inclusive start of the range as an ISO 8601 timestamp end: type: string format: date-time description: Exclusive end of the range as an ISO 8601 timestamp points: type: array items: $ref: '#/components/schemas/PullRequestActivityPoint' rangeTotals: $ref: '#/components/schemas/AnalyticsTotals' description: Totals over the requested range sources: type: array items: $ref: '#/components/schemas/AnalyticsSourceCount' usage: type: array items: $ref: '#/components/schemas/AnalyticsUsagePoint' users: type: array description: >- Per-user leaderboard for the range, ranked by compute minutes. Includes every current organization member except Replicas support accounts, which are omitted; users with no activity in the range report zeroes and a null top source items: $ref: '#/components/schemas/AnalyticsUserUsage' chatTurns: $ref: '#/components/schemas/AnalyticsChatTurnActivity' description: >- Inference runtime over the requested range, ranked by coding harness, model, and credential skillCalls: type: array description: Skill call counts over the requested range, ranked by skill name items: $ref: '#/components/schemas/AnalyticsCallBreakdown' mcpCalls: type: array description: MCP call counts over the requested range, ranked by server name items: $ref: '#/components/schemas/AnalyticsCallBreakdown' allTimeTotals: $ref: '#/components/schemas/AnalyticsTotals' description: >- The same totals over the organization's whole history, ignoring the requested range required: - bucket - start - end - points - sources - usage - users - rangeTotals - allTimeTotals - chatTurns - skillCalls - mcpCalls PullRequestActivityPoint: type: object description: >- Pull request cohort counts for a single time bucket, keyed by PR open date properties: bucket: type: string description: Bucket start as an ISO 8601 date (e.g. 2026-07-14) prsOpened: type: integer prsMerged: type: integer prsClosed: type: integer required: - bucket - prsOpened - prsMerged - prsClosed AnalyticsTotals: type: object description: >- Counted totals for one time window. Returned twice on an overview: once for the requested range, once for all time properties: workspacesCreated: type: integer prsOpened: type: integer prsMerged: type: integer prsClosed: type: integer computeMinutes: type: number description: Total metered agent runtime in minutes across all workspace sources required: - workspacesCreated - prsOpened - prsMerged - prsClosed - computeMinutes AnalyticsSourceCount: type: object description: Count of workspaces created from a given source properties: source: type: string description: >- Workspace source (e.g. dashboard, api, automation, slack, linear, github, gitlab) count: type: integer required: - source - count AnalyticsUsagePoint: type: object description: >- Compute minutes for a single time bucket, broken down by workspace source properties: bucket: type: string description: Bucket start as an ISO 8601 date (e.g. 2026-07-14) bySource: type: object description: Map of workspace source to compute minutes in this bucket additionalProperties: type: number required: - bucket - bySource AnalyticsUserUsage: type: object description: Usage metrics for a single organization user over the range properties: userId: type: string format: uuid description: Unique identifier for the user displayName: type: string description: User display name email: type: - string - 'null' description: User email address avatarUrl: type: - string - 'null' description: URL to the user's avatar image computeMinutes: type: number description: Compute minutes attributed to the user prsOpened: type: integer description: Pull requests opened by the user prsMerged: type: integer description: Pull requests merged by the user topSource: type: - string - 'null' enum: - api - dashboard - slack - linear - github - gitlab - automation - null description: Workspace source the user creates from most workspacesCreated: type: integer description: >- Workspaces this user created in the range, including any with no recorded source sources: type: array description: >- Workspaces this user created, grouped by source, highest first. Excludes workspaces with no recorded source items: $ref: '#/components/schemas/AnalyticsSourceCount' activity: type: array description: >- Daily compute minutes, ascending by date. Always daily regardless of `bucket`. Days with no usage are omitted items: $ref: '#/components/schemas/AnalyticsUserDay' required: - userId - displayName - email - avatarUrl - computeMinutes - prsOpened - prsMerged - topSource - workspacesCreated - sources - activity AnalyticsChatTurnActivity: type: object description: >- Inference runtime for an organization over the overview's requested range properties: totalSeconds: type: number agentProviders: type: array items: $ref: '#/components/schemas/AnalyticsChatTurnBreakdown' models: type: array items: $ref: '#/components/schemas/AnalyticsChatTurnBreakdown' credentials: type: array items: $ref: '#/components/schemas/AnalyticsChatTurnBreakdown' required: - totalSeconds - agentProviders - models - credentials AnalyticsCallBreakdown: type: object description: Ranked count for one skill or MCP server properties: name: type: string calls: type: integer required: - name - calls Error: type: object properties: error: type: string description: Error message details: type: - string - 'null' description: Additional error details required: - error AnalyticsUserDay: type: object description: >- One user's compute minutes on a single day. Always daily, regardless of the request's `bucket` properties: bucket: type: string format: date description: The day as YYYY-MM-DD minutes: type: integer description: Compute minutes metered to this user that day required: - bucket - minutes AnalyticsChatTurnBreakdown: type: object description: Ranked runtime total for one harness, model, or credential properties: key: type: string label: type: string seconds: type: number credentialOwner: type: string credentialOwnerEmail: type: string format: email credentialOwnerAvatarUrl: type: string format: uri required: - key - label - seconds responses: BadRequest: description: Bad request - Missing or invalid parameters content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Forbidden - The authenticated account cannot access this resource content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: http scheme: bearer description: >- API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys. ````