Skip to content
Ona API Reference
Ona Docs
API Reference

Usage

UsageService provides usage information about environments, users, and projects.

GetAdoptionUsageSummary
POST/gitpod.v1.UsageService/GetAdoptionUsageSummary
GetAgentTraceSummary
POST/gitpod.v1.UsageService/GetAgentTraceSummary
GetAgentTraceTimeSeries
POST/gitpod.v1.UsageService/GetAgentTraceTimeSeries
GetCoAuthorSummary
POST/gitpod.v1.UsageService/GetCoAuthorSummary
GetCoAuthorTimeSeries
POST/gitpod.v1.UsageService/GetCoAuthorTimeSeries
GetPrSummary
POST/gitpod.v1.UsageService/GetPrSummary
GetPrTimeSeries
POST/gitpod.v1.UsageService/GetPrTimeSeries
ListEnvironmentUsageRecords
POST/gitpod.v1.UsageService/ListEnvironmentUsageRecords
ModelsExpand Collapse
AgentTraceModelBreakdown object { linesAdded, linesRemoved, model, sessions }

AgentTraceModelBreakdown contains stats for a single LLM model.

linesAdded: optional string

Lines added by sessions using this model.

linesRemoved: optional string

Lines removed by sessions using this model.

model: optional SupportedModel

The model these stats are for.

One of the following:
"SUPPORTED_MODEL_UNSPECIFIED"
"SUPPORTED_MODEL_SONNET_3_5"
"SUPPORTED_MODEL_SONNET_3_7"
"SUPPORTED_MODEL_SONNET_3_7_EXTENDED"
"SUPPORTED_MODEL_SONNET_4"
"SUPPORTED_MODEL_SONNET_4_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_5"
"SUPPORTED_MODEL_SONNET_4_5_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_6"
"SUPPORTED_MODEL_SONNET_4_6_EXTENDED"
"SUPPORTED_MODEL_SONNET_5"
"SUPPORTED_MODEL_OPUS_4"
"SUPPORTED_MODEL_OPUS_4_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_5"
"SUPPORTED_MODEL_OPUS_4_5_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_6"
"SUPPORTED_MODEL_OPUS_4_6_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_7"
"SUPPORTED_MODEL_OPUS_4_8"
"SUPPORTED_MODEL_HAIKU_4_5"
"SUPPORTED_MODEL_OPENAI_4O"
"SUPPORTED_MODEL_OPENAI_4O_MINI"
"SUPPORTED_MODEL_OPENAI_O1"
"SUPPORTED_MODEL_OPENAI_O1_MINI"
"SUPPORTED_MODEL_OPENAI_AUTO"
sessions: optional string

Number of sessions that used this model.

AgentTraceSummary object { byModel, totalLinesAdded, totalLinesAddedTrend, 4 more }

AgentTraceSummary contains aggregate totals for a date range.

byModel: optional array of AgentTraceModelBreakdown { linesAdded, linesRemoved, model, sessions }

Per-model breakdown of session stats.

linesAdded: optional string

Lines added by sessions using this model.

linesRemoved: optional string

Lines removed by sessions using this model.

model: optional SupportedModel

The model these stats are for.

One of the following:
"SUPPORTED_MODEL_UNSPECIFIED"
"SUPPORTED_MODEL_SONNET_3_5"
"SUPPORTED_MODEL_SONNET_3_7"
"SUPPORTED_MODEL_SONNET_3_7_EXTENDED"
"SUPPORTED_MODEL_SONNET_4"
"SUPPORTED_MODEL_SONNET_4_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_5"
"SUPPORTED_MODEL_SONNET_4_5_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_6"
"SUPPORTED_MODEL_SONNET_4_6_EXTENDED"
"SUPPORTED_MODEL_SONNET_5"
"SUPPORTED_MODEL_OPUS_4"
"SUPPORTED_MODEL_OPUS_4_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_5"
"SUPPORTED_MODEL_OPUS_4_5_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_6"
"SUPPORTED_MODEL_OPUS_4_6_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_7"
"SUPPORTED_MODEL_OPUS_4_8"
"SUPPORTED_MODEL_HAIKU_4_5"
"SUPPORTED_MODEL_OPENAI_4O"
"SUPPORTED_MODEL_OPENAI_4O_MINI"
"SUPPORTED_MODEL_OPENAI_O1"
"SUPPORTED_MODEL_OPENAI_O1_MINI"
"SUPPORTED_MODEL_OPENAI_AUTO"
sessions: optional string

Number of sessions that used this model.

totalLinesAdded: optional string

Total lines added across all sessions.

totalLinesAddedTrend: optional number

Fractional change in total_lines_added compared to the previous period.

formatdouble
totalLinesRemoved: optional string

Total lines removed across all sessions.

totalLinesRemovedTrend: optional number

Fractional change in total_lines_removed compared to the previous period.

formatdouble
totalSessions: optional string

Total number of agent trace sessions in the date range.

totalSessionsTrend: optional number

Fractional change in total_sessions compared to the previous period of equal length. Computed as (current - previous) / previous. Zero when there is no previous data.

formatdouble
AgentTraceTimeBucket object { byModel, startTime, totalLinesAdded, 2 more }

AgentTraceTimeBucket contains stats for a single time period.

byModel: optional array of AgentTraceModelBreakdown { linesAdded, linesRemoved, model, sessions }

Per-model breakdown for this bucket.

linesAdded: optional string

Lines added by sessions using this model.

linesRemoved: optional string

Lines removed by sessions using this model.

model: optional SupportedModel

The model these stats are for.

One of the following:
"SUPPORTED_MODEL_UNSPECIFIED"
"SUPPORTED_MODEL_SONNET_3_5"
"SUPPORTED_MODEL_SONNET_3_7"
"SUPPORTED_MODEL_SONNET_3_7_EXTENDED"
"SUPPORTED_MODEL_SONNET_4"
"SUPPORTED_MODEL_SONNET_4_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_5"
"SUPPORTED_MODEL_SONNET_4_5_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_6"
"SUPPORTED_MODEL_SONNET_4_6_EXTENDED"
"SUPPORTED_MODEL_SONNET_5"
"SUPPORTED_MODEL_OPUS_4"
"SUPPORTED_MODEL_OPUS_4_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_5"
"SUPPORTED_MODEL_OPUS_4_5_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_6"
"SUPPORTED_MODEL_OPUS_4_6_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_7"
"SUPPORTED_MODEL_OPUS_4_8"
"SUPPORTED_MODEL_HAIKU_4_5"
"SUPPORTED_MODEL_OPENAI_4O"
"SUPPORTED_MODEL_OPENAI_4O_MINI"
"SUPPORTED_MODEL_OPENAI_O1"
"SUPPORTED_MODEL_OPENAI_O1_MINI"
"SUPPORTED_MODEL_OPENAI_AUTO"
sessions: optional string

Number of sessions that used this model.

startTime: optional string

Start of this time bucket.

formatdate-time
totalLinesAdded: optional string

Total lines added in this bucket.

totalLinesRemoved: optional string

Total lines removed in this bucket.

totalSessions: optional string

Number of agent trace sessions in this bucket.

CoAuthorSummary object { byTool, distinctAuthors, distinctAuthorsTrend, 6 more }

CoAuthorSummary contains aggregate totals for a date range.

byTool: optional array of ToolBreakdown { commits, distinctAuthors, linesAdded, 2 more }

Per-tool breakdown of contribution stats.

commits: optional string

Number of commits attributed to this tool.

distinctAuthors: optional string

Distinct authors who used this tool.

linesAdded: optional string

Lines added by this tool.

linesRemoved: optional string

Lines removed by this tool.

tool: optional CoAuthorTool

The tool these stats are for.

One of the following:
"CO_AUTHOR_TOOL_UNSPECIFIED"
"CO_AUTHOR_TOOL_NO_COAUTHOR"
"CO_AUTHOR_TOOL_HUMAN_COAUTHOR"
"CO_AUTHOR_TOOL_ONA"
"CO_AUTHOR_TOOL_GITHUB_COPILOT"
"CO_AUTHOR_TOOL_CURSOR"
"CO_AUTHOR_TOOL_OTHER"
"CO_AUTHOR_TOOL_CLAUDE"
"CO_AUTHOR_TOOL_CODEX"
distinctAuthors: optional string

Number of distinct authors (by author_hash).

distinctAuthorsTrend: optional number

Fractional change in distinct_authors compared to the previous period.

formatdouble
totalCommits: optional string

Total number of commits in the date range.

totalCommitsTrend: optional number

Fractional change in total_commits compared to the previous period of equal length. Computed as (current - previous) / previous. Zero when there is no previous data.

formatdouble
totalLinesAdded: optional string

Total lines added across all commits.

totalLinesAddedTrend: optional number

Fractional change in total_lines_added compared to the previous period.

formatdouble
totalLinesRemoved: optional string

Total lines removed across all commits.

totalLinesRemovedTrend: optional number

Fractional change in total_lines_removed compared to the previous period.

formatdouble
CoAuthorTimeBucket object { aiRatio, byTool, distinctAuthors, 4 more }

CoAuthorTimeBucket contains stats for a single time period.

aiRatio: optional number

Ratio of AI-assisted lines added to total lines added (0.0–1.0).

formatdouble
byTool: optional array of ToolBreakdown { commits, distinctAuthors, linesAdded, 2 more }

Per-tool breakdown for this bucket.

commits: optional string

Number of commits attributed to this tool.

distinctAuthors: optional string

Distinct authors who used this tool.

linesAdded: optional string

Lines added by this tool.

linesRemoved: optional string

Lines removed by this tool.

tool: optional CoAuthorTool

The tool these stats are for.

One of the following:
"CO_AUTHOR_TOOL_UNSPECIFIED"
"CO_AUTHOR_TOOL_NO_COAUTHOR"
"CO_AUTHOR_TOOL_HUMAN_COAUTHOR"
"CO_AUTHOR_TOOL_ONA"
"CO_AUTHOR_TOOL_GITHUB_COPILOT"
"CO_AUTHOR_TOOL_CURSOR"
"CO_AUTHOR_TOOL_OTHER"
"CO_AUTHOR_TOOL_CLAUDE"
"CO_AUTHOR_TOOL_CODEX"
distinctAuthors: optional string

Number of distinct authors (by author_hash) in this bucket.

startTime: optional string

Start of this time bucket.

formatdate-time
totalCommits: optional string

Total number of commits in this bucket (across all tools).

totalLinesAdded: optional string

Total lines added in this bucket (across all tools).

totalLinesRemoved: optional string

Total lines removed in this bucket (across all tools).

CoAuthorTool = "CO_AUTHOR_TOOL_UNSPECIFIED" or "CO_AUTHOR_TOOL_NO_COAUTHOR" or "CO_AUTHOR_TOOL_HUMAN_COAUTHOR" or 6 more

CoAuthorTool identifies the AI tool that co-authored a commit. UNSPECIFIED (0) is the proto default and must not appear in reported data. Use HUMAN for commits with no AI co-author.

One of the following:
"CO_AUTHOR_TOOL_UNSPECIFIED"
"CO_AUTHOR_TOOL_NO_COAUTHOR"
"CO_AUTHOR_TOOL_HUMAN_COAUTHOR"
"CO_AUTHOR_TOOL_ONA"
"CO_AUTHOR_TOOL_GITHUB_COPILOT"
"CO_AUTHOR_TOOL_CURSOR"
"CO_AUTHOR_TOOL_OTHER"
"CO_AUTHOR_TOOL_CLAUDE"
"CO_AUTHOR_TOOL_CODEX"
EnvironmentUsageRecord object { id, createdAt, environmentClassId, 5 more }

EnvironmentUsageRecord represents a record of an environment from start to stop.

id: optional string

Environment usage record ID.

createdAt: optional string

Time when the environment was created.

formatdate-time
environmentClassId: optional string

Environment class ID associated with the record.

environmentId: optional string

Environment ID associated with the record.

projectId: optional string

Project ID associated with the environment (if available).

runnerId: optional string

Runner ID associated with the environment.

stoppedAt: optional string

Time when the environment was stopped.

formatdate-time
userId: optional string

User ID is the ID of the user who created the environment associated with the record.

PrSummary object { deploymentFrequency, deploymentFrequencyTrend, leadTimeSeconds, 5 more }

PrSummary contains aggregate PR speed metrics for a date range.

deploymentFrequency: optional number

PRs merged to the default branch per week.

formatdouble
deploymentFrequencyTrend: optional number

Fractional change in deployment_frequency vs previous period. Computed as (current - previous) / previous.

formatdouble
leadTimeSeconds: optional number

Median lead time for changes in seconds (first commit → merge).

formatdouble
leadTimeTrend: optional number

Fractional change in lead_time_seconds vs previous period. Computed as (current - previous) / previous.

formatdouble
prsMergedCount: optional string

Total PRs merged in the date range.

prsMergedTrend: optional number

Fractional change in prs_merged_count vs previous period. Computed as (current - previous) / previous.

formatdouble
timeToFirstApprovalSeconds: optional number

Median time to first approval in seconds. Zero when no PRs in the range had approvals.

formatdouble
timeToFirstApprovalTrend: optional number

Fractional change in time_to_first_approval_seconds vs previous period. Computed as (current - previous) / previous.

formatdouble
PrTimeBucket object { deploys, leadTimeSeconds, prsMergedCount, 2 more }

PrTimeBucket contains PR speed metrics for a single time period.

deploys: optional string

Total number of deploys (merged PRs) in this bucket.

leadTimeSeconds: optional number

Median lead time in seconds for PRs merged in this bucket.

formatdouble
prsMergedCount: optional string

Number of PRs merged in this bucket.

startTime: optional string

Start of this time bucket.

formatdate-time
timeToFirstApprovalSeconds: optional number

Median time to first approval in seconds for PRs in this bucket. Zero when no PRs in the bucket had approvals.

formatdouble
Resolution = "RESOLUTION_UNSPECIFIED" or "RESOLUTION_HOURLY" or "RESOLUTION_DAILY" or 2 more

Resolution specifies the time granularity for time series data.

One of the following:
"RESOLUTION_UNSPECIFIED"
"RESOLUTION_HOURLY"
"RESOLUTION_DAILY"
"RESOLUTION_WEEKLY"
"RESOLUTION_MONTHLY"
SupportedModel = "SUPPORTED_MODEL_UNSPECIFIED" or "SUPPORTED_MODEL_SONNET_3_5" or "SUPPORTED_MODEL_SONNET_3_7" or 22 more

SupportedModel enumerates the LLM models available for agent executions

One of the following:
"SUPPORTED_MODEL_UNSPECIFIED"
"SUPPORTED_MODEL_SONNET_3_5"
"SUPPORTED_MODEL_SONNET_3_7"
"SUPPORTED_MODEL_SONNET_3_7_EXTENDED"
"SUPPORTED_MODEL_SONNET_4"
"SUPPORTED_MODEL_SONNET_4_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_5"
"SUPPORTED_MODEL_SONNET_4_5_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_6"
"SUPPORTED_MODEL_SONNET_4_6_EXTENDED"
"SUPPORTED_MODEL_SONNET_5"
"SUPPORTED_MODEL_OPUS_4"
"SUPPORTED_MODEL_OPUS_4_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_5"
"SUPPORTED_MODEL_OPUS_4_5_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_6"
"SUPPORTED_MODEL_OPUS_4_6_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_7"
"SUPPORTED_MODEL_OPUS_4_8"
"SUPPORTED_MODEL_HAIKU_4_5"
"SUPPORTED_MODEL_OPENAI_4O"
"SUPPORTED_MODEL_OPENAI_4O_MINI"
"SUPPORTED_MODEL_OPENAI_O1"
"SUPPORTED_MODEL_OPENAI_O1_MINI"
"SUPPORTED_MODEL_OPENAI_AUTO"
TimeSeriesPoint object { time, value }
time: optional string

Timestamp for this data point.

formatdate-time
value: optional number

The numerical value for this data point.

formatint32
ToolBreakdown object { commits, distinctAuthors, linesAdded, 2 more }

ToolBreakdown contains stats for a single AI tool (or human).

commits: optional string

Number of commits attributed to this tool.

distinctAuthors: optional string

Distinct authors who used this tool.

linesAdded: optional string

Lines added by this tool.

linesRemoved: optional string

Lines removed by this tool.

tool: optional CoAuthorTool

The tool these stats are for.

One of the following:
"CO_AUTHOR_TOOL_UNSPECIFIED"
"CO_AUTHOR_TOOL_NO_COAUTHOR"
"CO_AUTHOR_TOOL_HUMAN_COAUTHOR"
"CO_AUTHOR_TOOL_ONA"
"CO_AUTHOR_TOOL_GITHUB_COPILOT"
"CO_AUTHOR_TOOL_CURSOR"
"CO_AUTHOR_TOOL_OTHER"
"CO_AUTHOR_TOOL_CLAUDE"
"CO_AUTHOR_TOOL_CODEX"
UsageGetAdoptionUsageSummaryResponse object { activeUsersCount, activeUsersTrend, envRuntimePerUserSeconds, 7 more }
activeUsersCount: optional string

Count of active users in the date range.

activeUsersTrend: optional number

Fractional change in active_users_count vs previous period. Computed as (current - previous) / previous.

formatdouble
envRuntimePerUserSeconds: optional number

Average environment runtime in seconds per active user.

formatdouble
envRuntimePerUserTrend: optional number

Fractional change in env_runtime_per_user_seconds vs previous period. Computed as (current - previous) / previous.

formatdouble
powerUsersCount: optional string

Count of power users in the date range.

powerUsersThresholdSeconds: optional string

Threshold in seconds used to determine power users. Displayed to users so they understand the definition.

powerUsersTrend: optional number

Fractional change in power_users_count vs previous period. Computed as (current - previous) / previous.

formatdouble
sessionsCount: optional string

Count of environment sessions (total starts) in the date range.

sessionsTrend: optional number

Fractional change in sessions_count vs previous period. Computed as (current - previous) / previous.

formatdouble
sparkline: optional array of TimeSeriesPoint { time, value }

Sparkline data for the card’s trend line (typically ~4 weekly points).

time: optional string

Timestamp for this data point.

formatdate-time
value: optional number

The numerical value for this data point.

formatint32
UsageGetAgentTraceSummaryResponse object { sparkline, summary }
sparkline: optional array of TimeSeriesPoint { time, value }

Sparkline data for card rendering.

time: optional string

Timestamp for this data point.

formatdate-time
value: optional number

The numerical value for this data point.

formatint32
summary: optional AgentTraceSummary { byModel, totalLinesAdded, totalLinesAddedTrend, 4 more }

Summary totals and trends for the requested date range.

byModel: optional array of AgentTraceModelBreakdown { linesAdded, linesRemoved, model, sessions }

Per-model breakdown of session stats.

linesAdded: optional string

Lines added by sessions using this model.

linesRemoved: optional string

Lines removed by sessions using this model.

model: optional SupportedModel

The model these stats are for.

One of the following:
"SUPPORTED_MODEL_UNSPECIFIED"
"SUPPORTED_MODEL_SONNET_3_5"
"SUPPORTED_MODEL_SONNET_3_7"
"SUPPORTED_MODEL_SONNET_3_7_EXTENDED"
"SUPPORTED_MODEL_SONNET_4"
"SUPPORTED_MODEL_SONNET_4_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_5"
"SUPPORTED_MODEL_SONNET_4_5_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_6"
"SUPPORTED_MODEL_SONNET_4_6_EXTENDED"
"SUPPORTED_MODEL_SONNET_5"
"SUPPORTED_MODEL_OPUS_4"
"SUPPORTED_MODEL_OPUS_4_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_5"
"SUPPORTED_MODEL_OPUS_4_5_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_6"
"SUPPORTED_MODEL_OPUS_4_6_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_7"
"SUPPORTED_MODEL_OPUS_4_8"
"SUPPORTED_MODEL_HAIKU_4_5"
"SUPPORTED_MODEL_OPENAI_4O"
"SUPPORTED_MODEL_OPENAI_4O_MINI"
"SUPPORTED_MODEL_OPENAI_O1"
"SUPPORTED_MODEL_OPENAI_O1_MINI"
"SUPPORTED_MODEL_OPENAI_AUTO"
sessions: optional string

Number of sessions that used this model.

totalLinesAdded: optional string

Total lines added across all sessions.

totalLinesAddedTrend: optional number

Fractional change in total_lines_added compared to the previous period.

formatdouble
totalLinesRemoved: optional string

Total lines removed across all sessions.

totalLinesRemovedTrend: optional number

Fractional change in total_lines_removed compared to the previous period.

formatdouble
totalSessions: optional string

Total number of agent trace sessions in the date range.

totalSessionsTrend: optional number

Fractional change in total_sessions compared to the previous period of equal length. Computed as (current - previous) / previous. Zero when there is no previous data.

formatdouble
UsageGetAgentTraceTimeSeriesResponse object { timeSeries }
timeSeries: optional array of AgentTraceTimeBucket { byModel, startTime, totalLinesAdded, 2 more }

Time series of agent trace stats, bucketed by the requested resolution.

byModel: optional array of AgentTraceModelBreakdown { linesAdded, linesRemoved, model, sessions }

Per-model breakdown for this bucket.

linesAdded: optional string

Lines added by sessions using this model.

linesRemoved: optional string

Lines removed by sessions using this model.

model: optional SupportedModel

The model these stats are for.

One of the following:
"SUPPORTED_MODEL_UNSPECIFIED"
"SUPPORTED_MODEL_SONNET_3_5"
"SUPPORTED_MODEL_SONNET_3_7"
"SUPPORTED_MODEL_SONNET_3_7_EXTENDED"
"SUPPORTED_MODEL_SONNET_4"
"SUPPORTED_MODEL_SONNET_4_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_5"
"SUPPORTED_MODEL_SONNET_4_5_EXTENDED"
"SUPPORTED_MODEL_SONNET_4_6"
"SUPPORTED_MODEL_SONNET_4_6_EXTENDED"
"SUPPORTED_MODEL_SONNET_5"
"SUPPORTED_MODEL_OPUS_4"
"SUPPORTED_MODEL_OPUS_4_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_5"
"SUPPORTED_MODEL_OPUS_4_5_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_6"
"SUPPORTED_MODEL_OPUS_4_6_EXTENDED"
"SUPPORTED_MODEL_OPUS_4_7"
"SUPPORTED_MODEL_OPUS_4_8"
"SUPPORTED_MODEL_HAIKU_4_5"
"SUPPORTED_MODEL_OPENAI_4O"
"SUPPORTED_MODEL_OPENAI_4O_MINI"
"SUPPORTED_MODEL_OPENAI_O1"
"SUPPORTED_MODEL_OPENAI_O1_MINI"
"SUPPORTED_MODEL_OPENAI_AUTO"
sessions: optional string

Number of sessions that used this model.

startTime: optional string

Start of this time bucket.

formatdate-time
totalLinesAdded: optional string

Total lines added in this bucket.

totalLinesRemoved: optional string

Total lines removed in this bucket.

totalSessions: optional string

Number of agent trace sessions in this bucket.

UsageGetCoAuthorSummaryResponse object { sparkline, summary }
sparkline: optional array of TimeSeriesPoint { time, value }

Sparkline data for card rendering.

time: optional string

Timestamp for this data point.

formatdate-time
value: optional number

The numerical value for this data point.

formatint32
summary: optional CoAuthorSummary { byTool, distinctAuthors, distinctAuthorsTrend, 6 more }

Summary totals and trends for the requested date range.

byTool: optional array of ToolBreakdown { commits, distinctAuthors, linesAdded, 2 more }

Per-tool breakdown of contribution stats.

commits: optional string

Number of commits attributed to this tool.

distinctAuthors: optional string

Distinct authors who used this tool.

linesAdded: optional string

Lines added by this tool.

linesRemoved: optional string

Lines removed by this tool.

tool: optional CoAuthorTool

The tool these stats are for.

One of the following:
"CO_AUTHOR_TOOL_UNSPECIFIED"
"CO_AUTHOR_TOOL_NO_COAUTHOR"
"CO_AUTHOR_TOOL_HUMAN_COAUTHOR"
"CO_AUTHOR_TOOL_ONA"
"CO_AUTHOR_TOOL_GITHUB_COPILOT"
"CO_AUTHOR_TOOL_CURSOR"
"CO_AUTHOR_TOOL_OTHER"
"CO_AUTHOR_TOOL_CLAUDE"
"CO_AUTHOR_TOOL_CODEX"
distinctAuthors: optional string

Number of distinct authors (by author_hash).

distinctAuthorsTrend: optional number

Fractional change in distinct_authors compared to the previous period.

formatdouble
totalCommits: optional string

Total number of commits in the date range.

totalCommitsTrend: optional number

Fractional change in total_commits compared to the previous period of equal length. Computed as (current - previous) / previous. Zero when there is no previous data.

formatdouble
totalLinesAdded: optional string

Total lines added across all commits.

totalLinesAddedTrend: optional number

Fractional change in total_lines_added compared to the previous period.

formatdouble
totalLinesRemoved: optional string

Total lines removed across all commits.

totalLinesRemovedTrend: optional number

Fractional change in total_lines_removed compared to the previous period.

formatdouble
UsageGetCoAuthorTimeSeriesResponse object { timeSeries }
timeSeries: optional array of CoAuthorTimeBucket { aiRatio, byTool, distinctAuthors, 4 more }

Time series of contribution stats, bucketed by the requested resolution.

aiRatio: optional number

Ratio of AI-assisted lines added to total lines added (0.0–1.0).

formatdouble
byTool: optional array of ToolBreakdown { commits, distinctAuthors, linesAdded, 2 more }

Per-tool breakdown for this bucket.

commits: optional string

Number of commits attributed to this tool.

distinctAuthors: optional string

Distinct authors who used this tool.

linesAdded: optional string

Lines added by this tool.

linesRemoved: optional string

Lines removed by this tool.

tool: optional CoAuthorTool

The tool these stats are for.

One of the following:
"CO_AUTHOR_TOOL_UNSPECIFIED"
"CO_AUTHOR_TOOL_NO_COAUTHOR"
"CO_AUTHOR_TOOL_HUMAN_COAUTHOR"
"CO_AUTHOR_TOOL_ONA"
"CO_AUTHOR_TOOL_GITHUB_COPILOT"
"CO_AUTHOR_TOOL_CURSOR"
"CO_AUTHOR_TOOL_OTHER"
"CO_AUTHOR_TOOL_CLAUDE"
"CO_AUTHOR_TOOL_CODEX"
distinctAuthors: optional string

Number of distinct authors (by author_hash) in this bucket.

startTime: optional string

Start of this time bucket.

formatdate-time
totalCommits: optional string

Total number of commits in this bucket (across all tools).

totalLinesAdded: optional string

Total lines added in this bucket (across all tools).

totalLinesRemoved: optional string

Total lines removed in this bucket (across all tools).

UsageGetPrSummaryResponse object { sparkline, summary }
sparkline: optional array of TimeSeriesPoint { time, value }

Sparkline data for card rendering.

time: optional string

Timestamp for this data point.

formatdate-time
value: optional number

The numerical value for this data point.

formatint32
summary: optional PrSummary { deploymentFrequency, deploymentFrequencyTrend, leadTimeSeconds, 5 more }

Summary totals and trends for the requested date range.

deploymentFrequency: optional number

PRs merged to the default branch per week.

formatdouble
deploymentFrequencyTrend: optional number

Fractional change in deployment_frequency vs previous period. Computed as (current - previous) / previous.

formatdouble
leadTimeSeconds: optional number

Median lead time for changes in seconds (first commit → merge).

formatdouble
leadTimeTrend: optional number

Fractional change in lead_time_seconds vs previous period. Computed as (current - previous) / previous.

formatdouble
prsMergedCount: optional string

Total PRs merged in the date range.

prsMergedTrend: optional number

Fractional change in prs_merged_count vs previous period. Computed as (current - previous) / previous.

formatdouble
timeToFirstApprovalSeconds: optional number

Median time to first approval in seconds. Zero when no PRs in the range had approvals.

formatdouble
timeToFirstApprovalTrend: optional number

Fractional change in time_to_first_approval_seconds vs previous period. Computed as (current - previous) / previous.

formatdouble
UsageGetPrTimeSeriesResponse object { timeSeries }
timeSeries: optional array of PrTimeBucket { deploys, leadTimeSeconds, prsMergedCount, 2 more }

Time series of PR speed metrics, bucketed by the requested resolution.

deploys: optional string

Total number of deploys (merged PRs) in this bucket.

leadTimeSeconds: optional number

Median lead time in seconds for PRs merged in this bucket.

formatdouble
prsMergedCount: optional string

Number of PRs merged in this bucket.

startTime: optional string

Start of this time bucket.

formatdate-time
timeToFirstApprovalSeconds: optional number

Median time to first approval in seconds for PRs in this bucket. Zero when no PRs in the bucket had approvals.

formatdouble