> ## Documentation Index > Fetch the complete documentation index at: https://docs.codeant.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Developer Summary > Generates an AI-powered natural-language summary of a developer's contributions across the specified repositories and date range. Includes PR descriptions and an overall narrative of work done. If `repositories` is omitted, all repositories under the organization are used. ## OpenAPI ````yaml /openapi.json post /api/metrics/developer/summary/get openapi: 3.0.3 info: title: CodeAnt AI API description: >- API for code analysis (SAST, SCA, secrets, IaC) and developer productivity metrics. Supports GitHub, GitLab, Bitbucket, and Azure DevOps. version: 1.0.0 servers: - url: https://api.codeant.ai description: Production server security: [] tags: - name: Analysis description: Code analysis operations - name: Agent Analysis description: >- AI-powered agent analysis operations. Uses LLM-based code exploration agents to perform deep security threat hunting, bug finding, and custom analysis with reflection-based false positive filtering. - name: Developer Metrics — Teams description: >- Manage developer teams: create, update, delete teams and manage team membership. Teams are used to organize developers and scope metrics. - name: Developer Metrics description: >- Developer productivity and activity metrics: active developers, PR throughput, individual comparisons, and AI-generated summaries. All endpoints support GitHub, GitLab, Bitbucket, and Azure DevOps. paths: /api/metrics/developer/summary/get: post: tags: - Developer Metrics summary: Get Developer Summary description: >- Generates an AI-powered natural-language summary of a developer's contributions across the specified repositories and date range. Includes PR descriptions and an overall narrative of work done. If `repositories` is omitted, all repositories under the organization are used. operationId: getDevSummary requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DevSummaryRequest' examples: github: summary: GitHub value: platform: github org: my-org author: janedoe repositories: - my-org/backend-api start_date: '2025-01-01' end_date: '2025-03-01' gitlab: summary: GitLab value: platform: gitlab org: my-group author: janedoe repositories: - my-group/backend-api start_date: '2025-01-01' end_date: '2025-03-01' bitbucket: summary: Bitbucket value: platform: bitbucket org: my-workspace author: janedoe repositories: - my-workspace/backend-api start_date: '2025-01-01' end_date: '2025-03-01' azure_devops: summary: Azure DevOps value: platform: azure_devops org: my-org author: janedoe repositories: - my-org/backend-api start_date: '2025-01-01' end_date: '2025-03-01' responses: '200': description: Developer summary content: application/json: schema: type: object properties: metric: type: string example: dev_summary platform: type: string org: type: string author: type: string repositories: type: array items: type: string start_date: type: string format: date end_date: type: string format: date summary: type: string description: >- AI-generated natural-language summary of the developer's work pr_descriptions: type: array items: type: string description: Descriptions of PRs included in the analysis execution_time: type: number description: Time taken to generate the summary (seconds) '400': description: Bad request — missing or invalid parameters content: application/json: schema: $ref: '#/components/schemas/DevMetricsErrorResponse' example: error: 'Missing required parameters: author, start_date, end_date' '401': description: Unauthorized — missing, invalid, or insufficient access token content: application/json: schema: $ref: '#/components/schemas/DevMetricsErrorResponse' examples: missing_token: summary: Missing Authorization header value: error: Missing Authorization header. Use 'Bearer ' invalid_token: summary: Invalid or insufficient token value: error: >- Access token invalid or does not have access to this organization '404': description: >- No repositories found for the organization (when `repositories` is omitted) content: application/json: schema: $ref: '#/components/schemas/DevMetricsErrorResponse' example: error: No repositories found for this organization '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/DevMetricsStatusResponse' example: status: error message: Internal server error security: - BearerAuth: [] components: schemas: DevSummaryRequest: allOf: - $ref: '#/components/schemas/DateRangeRequest' - type: object required: - author properties: author: type: string description: Git author login/email to analyze example: janedoe repositories: type: array items: type: string description: >- List of repository names to scope the summary. If omitted, all repositories under the organization are used. example: - my-org/backend-api DevMetricsErrorResponse: type: object properties: error: type: string description: Error message DevMetricsStatusResponse: type: object properties: status: type: string enum: - success - error message: type: string description: Human-readable status message DateRangeRequest: allOf: - $ref: '#/components/schemas/DevMetricsBaseRequest' - type: object required: - start_date - end_date properties: start_date: type: string format: date description: Start of the date range (YYYY-MM-DD) example: '2025-01-01' end_date: type: string format: date description: End of the date range (YYYY-MM-DD) example: '2025-03-01' DevMetricsBaseRequest: type: object required: - platform - org properties: platform: type: string description: Version control platform enum: - github - gitlab - bitbucket - azure_devops - azuredevops example: github org: type: string description: Organization, workspace, or group name on the platform example: my-org github_base_url: type: string description: Base URL for GitHub (use for GitHub Enterprise Server) default: https://github.com example: https://github.com gitlab_base_url: type: string description: Base URL for GitLab (use for self-hosted GitLab instances) default: https://gitlab.com example: https://gitlab.com azure_devops_base_url: type: string description: Base URL for Azure DevOps (use for Azure DevOps Server) default: https://dev.azure.com example: https://dev.azure.com bitbucket_base_url: type: string description: Base URL for Bitbucket (use for Bitbucket Data Center/Server) default: https://api.bitbucket.org/2.0 example: https://api.bitbucket.org/2.0 securitySchemes: BearerAuth: type: http scheme: bearer description: >- Access token for the git provider (GitHub PAT, GitLab PAT, Bitbucket App Password, Azure DevOps PAT). Pass via `Authorization: Bearer ` header. ````