v1

latestOpenAPI 3.0.32026-07-26233989.2 KB

Developer Metrics

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.

post/api/metrics/developer/summary/get

Request body

platform'github' | 'gitlab' | 'bitbucket' | 'azure_devops' | 'azuredevops' required

Version control platform

orgstring required

Organization, workspace, or group name on the platform

github_base_urlstring

Base URL for GitHub (use for GitHub Enterprise Server)

gitlab_base_urlstring

Base URL for GitLab (use for self-hosted GitLab instances)

azure_devops_base_urlstring

Base URL for Azure DevOps (use for Azure DevOps Server)

bitbucket_base_urlstring

Base URL for Bitbucket (use for Bitbucket Data Center/Server)

start_datestring date required

Start of the date range (YYYY-MM-DD)

end_datestring date required

End of the date range (YYYY-MM-DD)

authorstring required

Git author login/email to analyze

repositoriesstring[]

List of repository names to scope the summary. If omitted, all repositories under the organization are used.

Example request

{
  "platform": "github",
  "org": "my-org",
  "github_base_url": "https://github.com",
  "gitlab_base_url": "https://gitlab.com",
  "azure_devops_base_url": "https://dev.azure.com",
  "bitbucket_base_url": "https://api.bitbucket.org/2.0",
  "start_date": "2025-01-01",
  "end_date": "2025-03-01",
  "author": "janedoe",
  "repositories": [
    "my-org/backend-api"
  ]
}

Response

Developer summary

metricstring

platformstring

orgstring

authorstring

repositoriesstring[]

start_datestring date

end_datestring date

summarystring

AI-generated natural-language summary of the developer's work

pr_descriptionsstring[]

Descriptions of PRs included in the analysis

execution_timenumber

Time taken to generate the summary (seconds)

Example response

{
  "metric": "dev_summary"
}