v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB

gitpod.v1.UsageService

GetAgentTraceTimeSeries

Gets agent trace data as a time series.

Use this method to:

Chart agent sessions and line changes over time
Select hourly, daily, weekly, or monthly buckets
Scope agent trace insights to a project, user, or team

Example

dateRange:
  startTime: "2024-01-01T00:00:00Z"
  endTime: "2024-02-01T00:00:00Z"
resolution: RESOLUTION_WEEKLY
projectId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"

post/gitpod.v1.UsageService/GetAgentTraceTimeSeries

Request body

projectIdstring

Optional project ID to scope results.

resolution'RESOLUTION_UNSPECIFIED' | 'RESOLUTION_HOURLY' | 'RESOLUTION_DAILY' | 'RESOLUTION_WEEKLY' | 'RESOLUTION_MONTHLY'

Resolution specifies the time granularity for time series data.

teamIdstring

Optional team ID to scope results to a specific team. Mutually exclusive with user_id.

userIdstring

Optional user ID to scope results to a specific user. Mutually exclusive with team_id.

Response

Success