---
title: "Get Developer Summary"
method: POST
path: "/api/metrics/developer/summary/get"
tags: ["Developer Metrics"]
---

# Get Developer Summary

`POST /api/metrics/developer/summary/get`

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.

## Request body

- DevSummaryRequest
  - `platform` 'github' | 'gitlab' | 'bitbucket' | 'azure_devops' | 'azuredevops', required — Version control platform
  - `org` string, required — Organization, workspace, or group name on the platform
  - `github_base_url` string — Base URL for GitHub (use for GitHub Enterprise Server)
  - `gitlab_base_url` string — Base URL for GitLab (use for self-hosted GitLab instances)
  - `azure_devops_base_url` string — Base URL for Azure DevOps (use for Azure DevOps Server)
  - `bitbucket_base_url` string — Base URL for Bitbucket (use for Bitbucket Data Center/Server)
  - `start_date` string, date, required — Start of the date range (YYYY-MM-DD)
  - `end_date` string, date, required — End of the date range (YYYY-MM-DD)
  - `author` string, required — Git author login/email to analyze
  - `repositories` string[] — List of repository names to scope the summary. If omitted, all repositories under the organization are used.

## Response `200`

Developer summary

- object
  - `metric` string
  - `platform` string
  - `org` string
  - `author` string
  - `repositories` string[]
  - `start_date` string, date
  - `end_date` string, date
  - `summary` string — AI-generated natural-language summary of the developer's work
  - `pr_descriptions` string[] — Descriptions of PRs included in the analysis
  - `execution_time` number — Time taken to generate the summary (seconds)

## Other responses

- `400` — Bad request - missing or invalid parameters
- `401` — Unauthorized - missing, invalid, or insufficient access token
- `404` — No repositories found for the organization (when `repositories` is omitted)
- `500` — Internal server error

---

[API](https://skmtc.dev/codeant/apis/codeant-ai-api.md) · [All operations](https://skmtc.dev/codeant/apis/codeant-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codeant/codeant-ai-api/revisions/d1eb7c083a39/schema)