openapi: 3.0.0 info: title: gitpod.v1 gitpod.v1.AccountService gitpod.v1.RunnerInteractionService API version: v1.0.0 description: RunnerInteractionService provides a way for the backend to interact with environment runners. servers: - url: https://api.gitpod.io description: Gitpod API tags: - description: RunnerInteractionService provides a way for the backend to interact with environment runners. name: gitpod.v1.RunnerInteractionService x-displayName: gitpod.v1.RunnerInteractionService paths: /gitpod.v1.RunnerInteractionService/GetHostAuthenticationTokenValue: servers: [] post: description: "Retrieves authentication token for accessing remote hosts.\n\n Use this method to:\n - Get host credentials\n - Access SCM tokens\n - Verify authentication\n\n ### Examples\n\n - Get token:\n\n Retrieves authentication token for a host.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n principalId: \"f53d2330-3795-4c5d-a1f3-453121af9c60\"\n host: \"github.com\"\n ```" operationId: gitpod.v1.RunnerInteractionService.GetHostAuthenticationTokenValue parameters: [] requestBody: content: application/json: examples: get_token: description: Retrieves authentication token for a host. value: host: github.com principalId: f53d2330-3795-4c5d-a1f3-453121af9c60 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.GetHostAuthenticationTokenValueRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetHostAuthenticationTokenValueResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetHostAuthenticationTokenValue tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetLatestVersion: servers: [] post: description: "Gets the latest version information for a runner.\n\n Use this method to:\n - Check for updates\n - Get version details\n - Verify compatibility\n\n ### Examples\n\n - Get version:\n\n Retrieves latest version info.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n currentVersion: \"1.2.3\"\n infrastructureVersion: \"4.5.6\"\n ```" operationId: gitpod.v1.RunnerInteractionService.GetLatestVersion parameters: [] requestBody: content: application/json: examples: get_version: description: Retrieves latest version info. value: currentVersion: 1.2.3 infrastructureVersion: 4.5.6 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.GetLatestVersionRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetLatestVersionResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetLatestVersion tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetManagedRunner: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.GetManagedRunner parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetManagedRunnerRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetManagedRunnerResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetManagedRunner tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetRunnerAgentExecution: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.GetRunnerAgentExecution parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerAgentExecutionRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerAgentExecutionResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetRunnerAgentExecution tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetRunnerConfiguration: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.GetRunnerConfiguration parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerConfigurationRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerConfigurationResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetRunnerConfiguration tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetRunnerEnvironment: servers: [] post: description: "Retrieves environment details for a specific runner.\n\n Use this method to:\n - Get environment configuration\n - Check environment status\n - Verify environment ownership\n\n ### Examples\n\n - Get environment:\n\n Retrieves environment details.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n environmentId: \"07e03a28-65a5-4d98-b532-8ea67b188048\"\n ```" operationId: gitpod.v1.RunnerInteractionService.GetRunnerEnvironment parameters: [] requestBody: content: application/json: examples: get_environment: description: Retrieves environment details. value: environmentId: 07e03a28-65a5-4d98-b532-8ea67b188048 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerEnvironmentRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerEnvironmentResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetRunnerEnvironment tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetRunnerEnvironmentSnapshot: servers: [] post: description: "Gets details about a specific snapshot including its status, size, and metadata.\n\n Use this method to:\n - Check if a snapshot is ready for use\n - Monitor snapshot creation progress\n - Get snapshot size and creation details\n - Retrieve provider-specific snapshot information" operationId: gitpod.v1.RunnerInteractionService.GetRunnerEnvironmentSnapshot parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerEnvironmentSnapshotRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerEnvironmentSnapshotResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetRunnerEnvironmentSnapshot tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetRunnerLLMIntegration: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.GetRunnerLLMIntegration parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerLLMIntegrationRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerLLMIntegrationResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetRunnerLLMIntegration tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/GetRunnerWarmPool: servers: [] post: description: "Gets details about a specific warm pool assigned to this runner.\n\n Use this method to read the full warm pool spec after receiving\n an EventWarmPoolSpecChange event." operationId: gitpod.v1.RunnerInteractionService.GetRunnerWarmPool parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerWarmPoolRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.GetRunnerWarmPoolResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: GetRunnerWarmPool tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListManagedRunners: servers: [] post: description: Lists all runners managed by this runner manager. operationId: gitpod.v1.RunnerInteractionService.ListManagedRunners parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListManagedRunnersRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListManagedRunnersResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListManagedRunners tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerAgentExecutions: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.ListRunnerAgentExecutions parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerAgentExecutionsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerAgentExecutionsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerAgentExecutions tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerEnvironmentClasses: servers: [] post: description: "Lists environment classes configured for a runner.\n\n Use this method to:\n - View available classes\n - Check class configurations\n - Monitor class status\n\n ### Examples\n\n - List classes:\n\n Shows environment classes for a runner.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n pagination:\n pageSize: 20\n ```" operationId: gitpod.v1.RunnerInteractionService.ListRunnerEnvironmentClasses parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: examples: list_classes: description: Shows environment classes for a runner. value: pagination: pageSize: 20 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentClassesRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentClassesResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerEnvironmentClasses tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerEnvironmentSnapshots: servers: [] post: description: "Lists all snapshots matching the specified criteria.\n\n Use this method to find and monitor snapshots across your organization.\n Results are ordered by creation time with newest snapshots first." operationId: gitpod.v1.RunnerInteractionService.ListRunnerEnvironmentSnapshots parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentSnapshotsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentSnapshotsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerEnvironmentSnapshots tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerEnvironments: servers: [] post: description: "Lists all environments managed by a runner.\n\n Use this method to:\n - View assigned environments\n - Monitor environment status\n - Check environment assignments\n\n ### Examples\n\n - List environments:\n\n Shows all environments for a runner.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n pagination:\n pageSize: 20\n ```\n\n - List specific environments:\n\n Shows details for specific environment IDs.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n environmentIds: [\"07e03a28-65a5-4d98-b532-8ea67b188048\"]\n pagination:\n pageSize: 20\n ```" operationId: gitpod.v1.RunnerInteractionService.ListRunnerEnvironments parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: examples: list_environments: description: Shows all environments for a runner. value: pagination: pageSize: 20 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 list_specific_environments: description: Shows details for specific environment IDs. value: environmentIds: - 07e03a28-65a5-4d98-b532-8ea67b188048 pagination: pageSize: 20 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerEnvironments tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerIntegrations: servers: [] post: description: "Lists integrations configured for a runner.\n\n Use this method to:\n - View available integrations\n - Check integration configurations\n - Monitor integration status\n\n ### Examples\n\n - List integrations:\n\n Shows integrations for a runner.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n pagination:\n pageSize: 20\n ```" operationId: gitpod.v1.RunnerInteractionService.ListRunnerIntegrations parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: examples: list_integrations: description: Shows integrations for a runner. value: pagination: pageSize: 20 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerIntegrationsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerIntegrationsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerIntegrations tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerLLMIntegrations: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.ListRunnerLLMIntegrations parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerLLMIntegrationsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerLLMIntegrationsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerLLMIntegrations tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerSCMIntegrations: servers: [] post: description: "Lists SCM integrations configured for a runner.\n\n Use this method to:\n - View SCM configurations\n - Check integration status\n - Monitor available SCMs\n\n ### Examples\n\n - List integrations:\n\n Shows SCM integrations for a runner.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n pagination:\n pageSize: 20\n ```" operationId: gitpod.v1.RunnerInteractionService.ListRunnerSCMIntegrations parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: examples: list_integrations: description: Shows SCM integrations for a runner. value: pagination: pageSize: 20 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerSCMIntegrationsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerSCMIntegrationsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerSCMIntegrations tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ListRunnerWarmPools: servers: [] post: description: "Lists all warm pools assigned to this runner.\n\n Use this method on startup to discover all warm pools the runner\n should be managing." operationId: gitpod.v1.RunnerInteractionService.ListRunnerWarmPools parameters: - in: query name: pageSize schema: default: 25 maximum: 100 minimum: 0 type: integer - in: query name: token schema: default: '' type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerWarmPoolsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ListRunnerWarmPoolsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ListRunnerWarmPools tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/MarkRunnerActive: servers: [] post: description: "Maintains the active status of a runner through periodic heartbeat signals. The runner must\n call this method every 30 seconds to indicate it's healthy and ready to accept workloads.\n\n Use this method to:\n - Keep runners marked as available in the system\n - Maintain health check status\n - Prevent automatic deregistration\n - Signal readiness for new workloads\n\n ### Examples\n\n - Send heartbeat:\n\n Marks a runner as active and healthy.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n ```" operationId: gitpod.v1.RunnerInteractionService.MarkRunnerActive parameters: [] requestBody: content: application/json: examples: send_heartbeat: description: Marks a runner as active and healthy. value: runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.MarkRunnerActiveRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.MarkRunnerActiveResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: MarkRunnerActive tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ReportLLMUsage: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.ReportLLMUsage parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ReportLLMUsageRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ReportLLMUsageResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ReportLLMUsage tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/ReportRunnerMetrics: servers: [] post: description: "Reports runner operational metrics to the management plane for forwarding\n to Grafana Cloud. The runner gathers metrics from its local Prometheus\n registry, encodes them as a Prometheus WriteRequest protobuf, and\n Snappy-compresses the payload." operationId: gitpod.v1.RunnerInteractionService.ReportRunnerMetrics parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ReportRunnerMetricsRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.ReportRunnerMetricsResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: ReportRunnerMetrics tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/SendResponse: servers: [] post: description: "Sends a response to a previously received request.\n\n Use this method to:\n - Respond to requests\n - Report operation results\n - Handle errors\n\n ### Examples\n\n - Send response:\n\n Responds to a request.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n requestId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n callParseContext:\n resp:\n originalContextUrl: \"https://github.com/org/repo\"\n git:\n host: \"github.com\"\n owner: \"org\"\n repo: \"repo\"\n branch: \"main\"\n cloneUrl: \"https://github.com/org/repo.git\"\n ```" operationId: gitpod.v1.RunnerInteractionService.SendResponse parameters: [] requestBody: content: application/json: examples: send_response: description: Responds to a request. value: callParseContext: resp: git: branch: main cloneUrl: https://github.com/org/repo.git host: github.com owner: org repo: repo originalContextUrl: https://github.com/org/repo requestId: d2c94c27-3b76-4a42-b88c-95a85e392c68 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.SendResponseRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.SendResponseResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: SendResponse tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/Signup: servers: [] post: description: "Establishes initial connection between a runner and the Gitpod backend. This is the first\n call a runner makes to register itself and establish its identity.\n\n Use this method to:\n - Register new runners with the platform\n - Exchange cryptographic keys for secure communication\n - Declare supported environment classes and capabilities\n - Initialize runner configuration\n\n ### Examples\n\n - Register runner:\n\n Registers a new runner with its public key and supported environment classes.\n\n ```yaml\n publicKey: \"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\" # 32 bytes of zeros, base64 encoded\n environmentClasses:\n - id: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n runnerId: \"f53d2330-3795-4c5d-a1f3-453121af9c60\"\n displayName: \"Large Instance\"\n description: \"8 CPU, 16GB RAM\"\n enabled: true\n configuration:\n - key: \"cpu\"\n value: \"8\"\n - key: \"memory\"\n value: \"16384\"\n ```" operationId: gitpod.v1.RunnerInteractionService.Signup parameters: [] requestBody: content: application/json: examples: register_runner: description: Registers a new runner with its public key and supported environment classes. value: environmentClasses: - configuration: - key: cpu value: '8' - key: memory value: '16384' description: 8 CPU, 16GB RAM displayName: Large Instance enabled: true id: d2c94c27-3b76-4a42-b88c-95a85e392c68 runnerId: f53d2330-3795-4c5d-a1f3-453121af9c60 publicKey: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA schema: $ref: '#/components/schemas/gitpod.v1.SignupRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.SignupResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: Signup tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/UpdateRunnerAgentExecution: servers: [] post: operationId: gitpod.v1.RunnerInteractionService.UpdateRunnerAgentExecution parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerAgentExecutionRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerAgentExecutionResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: UpdateRunnerAgentExecution tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/UpdateRunnerConfigurationSchema: servers: [] post: description: "Updates the configuration schema for a runner.\n\n Use this method to:\n - Define configuration options\n - Update schema definitions\n - Set validation rules\n\n ### Examples\n\n - Update schema:\n\n Updates runner configuration schema.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n configSchema:\n version: \"1.0\"\n runnerConfig:\n - id: \"region\"\n name: \"Region\"\n description: \"Deployment region\"\n required: true\n string:\n default: \"us-west\"\n pattern: \"^[a-z]+-[a-z]+-[0-9]+$\"\n - id: \"autoUpdate\"\n name: \"Auto Update\"\n description: \"Enable automatic updates\"\n required: true\n bool:\n default: true\n ```" operationId: gitpod.v1.RunnerInteractionService.UpdateRunnerConfigurationSchema parameters: [] requestBody: content: application/json: examples: update_schema: description: Updates runner configuration schema. value: configSchema: runnerConfig: - description: Deployment region id: region name: Region required: true string: default: us-west pattern: ^[a-z]+-[a-z]+-[0-9]+$ - bool: default: true description: Enable automatic updates id: autoUpdate name: Auto Update required: true version: '1.0' runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerConfigurationSchemaRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerConfigurationSchemaResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: UpdateRunnerConfigurationSchema tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/UpdateRunnerEnvironmentSnapshotStatus: servers: [] post: description: "Updates the status of a snapshot during its lifecycle.\n\n Use this method to:\n - Report snapshot creation progress\n - Update completion percentage\n - Set snapshot phase (pending, creating, available, failed)\n - Provide provider-specific snapshot details\n - Report failure messages when snapshot creation fails" operationId: gitpod.v1.RunnerInteractionService.UpdateRunnerEnvironmentSnapshotStatus parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerEnvironmentSnapshotStatusRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerEnvironmentSnapshotStatusResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: UpdateRunnerEnvironmentSnapshotStatus tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/UpdateRunnerEnvironmentStatus: servers: [] post: description: "Provides comprehensive status updates about a managed environment. This method allows\n runners to report detailed state information about environments they're managing.\n\n Use this method to:\n - Report current environment phase and health status\n - Update machine and container states\n - Signal content and devcontainer readiness\n - Provide access URLs and endpoints\n - Report warnings or failure conditions\n\n ### Examples\n\n - Update status:\n\n Provides a detailed status update for an environment.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n environmentId: \"07e03a28-65a5-4d98-b532-8ea67b188048\"\n status:\n phase: ENVIRONMENT_PHASE_RUNNING\n statusVersion: \"1\"\n failureMessage: []\n warningMessage: []\n machine:\n phase: PHASE_RUNNING\n content:\n phase: CONTENT_PHASE_READY\n devcontainer:\n phase: PHASE_RUNNING\n environmentUrls:\n logs: \"https://logs.gitpod.io/environment\"\n ports: []\n ssh:\n url: \"ssh://ssh.gitpod.io:22\"\n ```" operationId: gitpod.v1.RunnerInteractionService.UpdateRunnerEnvironmentStatus parameters: [] requestBody: content: application/json: examples: update_status: description: Provides a detailed status update for an environment. value: environmentId: 07e03a28-65a5-4d98-b532-8ea67b188048 runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 status: content: phase: CONTENT_PHASE_READY devcontainer: phase: PHASE_RUNNING environmentUrls: logs: https://logs.gitpod.io/environment ports: [] ssh: url: ssh://ssh.gitpod.io:22 failureMessage: [] machine: phase: PHASE_RUNNING phase: ENVIRONMENT_PHASE_RUNNING statusVersion: '1' warningMessage: [] schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerEnvironmentStatusRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerEnvironmentStatusResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: UpdateRunnerEnvironmentStatus tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/UpdateRunnerStatus: servers: [] post: description: "Updates the runner's status and capabilities.\n\n Use this method to:\n - Report runner health\n - Update version information\n - Signal system changes\n - Configure capabilities\n\n ### Examples\n\n - Update status:\n\n Updates runner status and details.\n\n ```yaml\n runnerId: \"d2c94c27-3b76-4a42-b88c-95a85e392c68\"\n version: \"1.2.3\"\n systemDetails: \"Linux x86_64\"\n logUrl: \"https://logs.example.com/runner\"\n region: \"us-west\"\n capabilities: [\"RUNNER_CAPABILITY_SECRET_CONTAINER_REGISTRY\"]\n ```" operationId: gitpod.v1.RunnerInteractionService.UpdateRunnerStatus parameters: [] requestBody: content: application/json: examples: update_status: description: Updates runner status and details. value: capabilities: - RUNNER_CAPABILITY_SECRET_CONTAINER_REGISTRY logUrl: https://logs.example.com/runner region: us-west runnerId: d2c94c27-3b76-4a42-b88c-95a85e392c68 systemDetails: Linux x86_64 version: 1.2.3 schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerStatusRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerStatusResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: UpdateRunnerStatus tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/UpdateRunnerWarmPoolStatus: servers: [] post: description: "Updates the status of a warm pool.\n\n Use this method to:\n - Report warm pool phase transitions (ready, degraded)\n - Report failure messages when pool instances cannot be created" operationId: gitpod.v1.RunnerInteractionService.UpdateRunnerWarmPoolStatus parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerWarmPoolStatusRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/gitpod.v1.UpdateRunnerWarmPoolStatusResponse' description: Success default: content: application/json: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: UpdateRunnerWarmPoolStatus tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/WatchManagedRunners: servers: [] post: description: Watches for changes to managed runners. operationId: gitpod.v1.RunnerInteractionService.WatchManagedRunners parameters: [] requestBody: content: application/connect+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' application/connect+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' application/grpc: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' application/grpc+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' application/grpc+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' application/grpc-web: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' application/grpc-web+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' application/grpc-web+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersRequest' required: true responses: '200': content: application/connect+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' application/connect+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' application/grpc: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' application/grpc+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' application/grpc+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' application/grpc-web: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' application/grpc-web+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' application/grpc-web+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse' description: Success default: content: application/connect+json: schema: $ref: '#/components/schemas/connect.error' application/connect+proto: schema: $ref: '#/components/schemas/connect.error' application/grpc: schema: $ref: '#/components/schemas/connect.error' application/grpc+json: schema: $ref: '#/components/schemas/connect.error' application/grpc+proto: schema: $ref: '#/components/schemas/connect.error' application/grpc-web: schema: $ref: '#/components/schemas/connect.error' application/grpc-web+json: schema: $ref: '#/components/schemas/connect.error' application/grpc-web+proto: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: WatchManagedRunners tags: - gitpod.v1.RunnerInteractionService /gitpod.v1.RunnerInteractionService/WatchRequests: servers: [] post: description: "Streams requests that need to be handled by the runner.\n\n Use this method to:\n - Receive configuration changes\n - Handle environment updates\n - Process integration events\n - Monitor real-time events" operationId: gitpod.v1.RunnerInteractionService.WatchRequests parameters: [] requestBody: content: application/connect+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' application/connect+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' application/grpc: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' application/grpc+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' application/grpc+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' application/grpc-web: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' application/grpc-web+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' application/grpc-web+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsRequest' required: true responses: '200': content: application/connect+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' application/connect+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' application/grpc: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' application/grpc+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' application/grpc+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' application/grpc-web: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' application/grpc-web+json: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' application/grpc-web+proto: schema: $ref: '#/components/schemas/gitpod.v1.WatchRequestsResponse' description: Success default: content: application/connect+json: schema: $ref: '#/components/schemas/connect.error' application/connect+proto: schema: $ref: '#/components/schemas/connect.error' application/grpc: schema: $ref: '#/components/schemas/connect.error' application/grpc+json: schema: $ref: '#/components/schemas/connect.error' application/grpc+proto: schema: $ref: '#/components/schemas/connect.error' application/grpc-web: schema: $ref: '#/components/schemas/connect.error' application/grpc-web+json: schema: $ref: '#/components/schemas/connect.error' application/grpc-web+proto: schema: $ref: '#/components/schemas/connect.error' description: Error security: - bearerAuth: [] summary: WatchRequests tags: - gitpod.v1.RunnerInteractionService components: schemas: gitpod.v1.EnvironmentStatus.DevContainer.Phase: enum: - PHASE_UNSPECIFIED - PHASE_CREATING - PHASE_RUNNING - PHASE_STOPPED - PHASE_FAILED title: Phase type: string gitpod.v1.GetRunnerWarmPoolRequest: additionalProperties: false properties: runnerId: description: The runner's identity format: uuid title: runner_id type: string warmPoolId: description: warm_pool_id specifies the warm pool to retrieve format: uuid title: warm_pool_id type: string required: - runnerId - warmPoolId title: GetRunnerWarmPoolRequest type: object gitpod.v1.CallPing.Request: additionalProperties: false properties: empty: type: boolean title: Request type: object gitpod.v1.WakeEvent.EnvironmentPhaseReached: additionalProperties: false properties: environmentId: title: environment_id type: string failureMessage: items: type: string title: failure_message type: array phase: description: The phase the environment reached (e.g. "running", "stopped", "deleted"). title: phase type: string title: EnvironmentPhaseReached type: object gitpod.v1.MarkRunnerActiveRequest: additionalProperties: false properties: runnerId: description: The runner's identity format: uuid title: runner_id type: string title: MarkRunnerActiveRequest type: object gitpod.v1.CallSendMessageToAgentExecution.Response: additionalProperties: false title: Response type: object gitpod.v1.RunnerConfigurationSchema.EnumField.Value: additionalProperties: false properties: detail: title: detail type: string subtitle: title: subtitle type: string title: title: title type: string title: Value type: object gitpod.v1.ListRunnerLLMIntegrationsRequest: additionalProperties: false properties: filter: $ref: '#/components/schemas/gitpod.v1.ListRunnerLLMIntegrationsRequest.Filter' title: filter pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing LLM integrations title: pagination runnerId: description: The runner's identity format: uuid title: runner_id type: string title: ListRunnerLLMIntegrationsRequest type: object gitpod.v1.EnvironmentSpec.Secret: additionalProperties: false oneOf: - not: anyOf: - required: - containerRegistryBasicAuthHost - required: - environmentVariable - required: - filePath - required: - gitCredentialHost required: - apiOnly - not: anyOf: - required: - apiOnly - required: - environmentVariable - required: - filePath - required: - gitCredentialHost required: - containerRegistryBasicAuthHost - not: anyOf: - required: - apiOnly - required: - containerRegistryBasicAuthHost - required: - filePath - required: - gitCredentialHost required: - environmentVariable - not: anyOf: - required: - apiOnly - required: - containerRegistryBasicAuthHost - required: - environmentVariable - required: - gitCredentialHost required: - filePath - not: anyOf: - required: - apiOnly - required: - containerRegistryBasicAuthHost - required: - environmentVariable - required: - filePath required: - gitCredentialHost properties: apiOnly: description: "api_only indicates the secret is only available via API/CLI.\n These secrets are resolved but NOT automatically injected into services or devcontainers." title: api_only type: boolean containerRegistryBasicAuthHost: description: container_registry_basic_auth_host is the hostname of the container registry that supports basic auth title: container_registry_basic_auth_host type: string credentialProxy: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.Secret.CredentialProxy' description: "credential_proxy configures transparent credential injection via the\n credential proxy. When set, the credential proxy intercepts HTTPS\n traffic to the target hosts and replaces the dummy secret value with\n the real value in the specified HTTP header. The real secret value is\n never exposed in the environment.\n This field is orthogonal to mount — a secret can be both mounted (e.g.\n as a git credential) and proxied at the same time." title: credential_proxy environmentVariable: title: environment_variable type: string filePath: description: file_path is the path inside the devcontainer where the secret is mounted title: file_path type: string gitCredentialHost: title: git_credential_host type: string id: description: id is the unique identifier of the secret. title: id type: string name: description: name is the human readable description of the secret title: name type: string scope: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.Secret.Scope' description: "scope indicates where this secret originated from.\n Used to filter secrets during build (only org and project secrets are injected)." title: scope session: description: "session indicated the current session of the secret.\n When the session does not change, secrets are not reloaded in the environment." title: session type: string source: description: source is the source of the secret, for now control-plane or runner title: source type: string sourceRef: description: source_ref into the source, in case of control-plane this is uuid of the secret title: source_ref type: string title: Secret type: object gitpod.v1.GetLatestVersionRequest: additionalProperties: false properties: currentVersion: description: The current version of the runner title: current_version type: string infrastructureVersion: description: The version of the infrastructure title: infrastructure_version type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string required: - runnerId title: GetLatestVersionRequest type: object gitpod.v1.EnvironmentStatus.AutomationsFile: additionalProperties: false properties: automationsFilePath: description: automations_file_path is the path to the automations file relative to the repo root. title: automations_file_path type: string automationsFilePresence: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.AutomationsFile.Presence' description: automations_file_presence indicates how an automations file is present in the environment. title: automations_file_presence failureMessage: description: "failure_message contains the reason the automations file failed to be applied.\n This is only set if the phase is FAILED." title: failure_message type: string phase: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.ContentPhase' description: phase is the current phase of the automations file. title: phase session: description: session is the automations file session that is currently applied in the environment. title: session type: string warningMessage: description: warning_message contains warnings, e.g. when no triggers are defined in the automations file. title: warning_message type: string title: AutomationsFile type: object gitpod.v1.CallListSCMOrganizations.Response: additionalProperties: false properties: organizations: description: List of organizations the user belongs to items: $ref: '#/components/schemas/gitpod.v1.ListSCMOrganizationsResponse.SCMOrganization' title: organizations type: array title: Response type: object gitpod.v1.CallCheckAuthenticationForHost.Response: additionalProperties: false properties: resp: $ref: '#/components/schemas/gitpod.v1.CheckAuthenticationForHostResponse' title: resp title: Response type: object gitpod.v1.GetRunnerAgentExecutionRequest: additionalProperties: false properties: agentExecutionId: format: uuid title: agent_execution_id type: string runnerId: format: uuid title: runner_id type: string title: GetRunnerAgentExecutionRequest type: object gitpod.v1.EnvironmentStatus.Content: additionalProperties: false properties: contentLocationInMachine: description: content_location_in_machine is the location of the content in the machine title: content_location_in_machine type: string failureMessage: description: failure_message contains the reason the content initialization failed. title: failure_message type: string git: $ref: '#/components/schemas/gitpod.v1.EnvironmentGitStatus' description: "git is the Git working copy status of the environment.\n Note: this is a best-effort field and more often than not will not be\n present. Its absence does not indicate the absence of a working copy." title: git phase: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.ContentPhase' description: phase is the current phase of the environment content title: phase session: description: session is the session that is currently active in the environment. title: session type: string warningMessage: description: warning_message contains warnings, e.g. when the content is present but not in the expected state. title: warning_message type: string title: Content type: object gitpod.v1.Subject: additionalProperties: false properties: id: description: id is the UUID of the subject format: uuid title: id type: string principal: $ref: '#/components/schemas/gitpod.v1.Principal' description: Principal is the principal of the subject title: principal title: Subject type: object gitpod.v1.CallParseContext.Request: additionalProperties: false properties: contextUrl: title: context_url type: string principalId: title: principal_id type: string title: Request type: object gitpod.v1.ListRunnerEnvironmentClassesRequest.Filter: additionalProperties: false properties: environmentClassIds: description: environment_class_ids filters the response to only environment classes with these IDs items: format: uuid maxItems: 25 type: string maxItems: 25 title: environment_class_ids type: array title: Filter type: object gitpod.v1.WatchManagedRunnersResponse.EventType: enum: - EVENT_TYPE_UNSPECIFIED - EVENT_TYPE_CREATED - EVENT_TYPE_DELETED - EVENT_TYPE_HIBERNATED - EVENT_TYPE_WAKE title: EventType type: string gitpod.v1.GetRunnerAgentExecutionResponse: additionalProperties: false properties: agentExecution: $ref: '#/components/schemas/gitpod.v1.RunnerAgentExecution' title: agent_execution title: GetRunnerAgentExecutionResponse type: object gitpod.v1.UpdateRunnerWarmPoolStatusResponse: additionalProperties: false title: UpdateRunnerWarmPoolStatusResponse type: object gitpod.v1.Integration: additionalProperties: false description: Integration represents an instantiated integration within an organization properties: auth: $ref: '#/components/schemas/gitpod.v1.IntegrationAuthentication' description: auth defines which authentication methods are enabled for this integration title: auth capabilities: $ref: '#/components/schemas/gitpod.v1.IntegrationCapabilities' description: capabilities defines which capabilities are enabled for this integration title: capabilities enabled: description: enabled indicates if this integration is currently enabled title: enabled type: boolean host: description: host is the hostname for this integration (e.g., "linear.app") - optional, inherits from definition title: host type: string id: description: id is the unique identifier for this integration instance title: id type: string integrationDefinitionId: description: integration_definition_id references the integration definition ID title: integration_definition_id type: string organizationId: description: organization_id is the organization this integration belongs to title: organization_id type: string runnerId: description: runner_id - if set, restricts integration to specific runner title: runner_id type: string required: - id - organizationId - integrationDefinitionId title: Integration type: object gitpod.v1.ParseContextURLResponse: additionalProperties: false properties: git: $ref: '#/components/schemas/gitpod.v1.ParseContextURLResponse.GitContext' title: git issue: $ref: '#/components/schemas/gitpod.v1.ParseContextURLResponse.Issue' title: issue originalContextUrl: title: original_context_url type: string pr: $ref: '#/components/schemas/gitpod.v1.ParseContextURLResponse.PullRequest' deprecated: true title: pr projectIds: description: project_ids is a list of projects to which the context URL belongs to. items: type: string title: project_ids type: array pullRequest: $ref: '#/components/schemas/gitpod.v1.PullRequest' title: pull_request scmId: description: scm_id is the unique identifier of the SCM provider (e.g., "github", "gitlab", "bitbucket") title: scm_id type: string title: ParseContextURLResponse type: object gitpod.v1.IntegrationAuthentication: additionalProperties: false description: IntegrationAuthentication defines authentication requirements and options properties: apiKey: $ref: '#/components/schemas/gitpod.v1.IntegrationAPIKeyConfig' description: api_key configuration if API key authentication is supported title: api_key oauth: $ref: '#/components/schemas/gitpod.v1.IntegrationOAuthConfig' description: oauth configuration if OAuth authentication is supported title: oauth proprietaryApp: $ref: '#/components/schemas/gitpod.v1.IntegrationProprietaryAppConfig' description: proprietary configuration if supported title: proprietary_app requiresAuth: description: requires_auth indicates if authentication is required for this integration title: requires_auth type: boolean title: IntegrationAuthentication type: object gitpod.v1.WakeEvent.LoopRetrigger: additionalProperties: false properties: outputs: additionalProperties: title: value type: string title: outputs type: object unmetConditions: items: $ref: '#/components/schemas/gitpod.v1.WakeEvent.LoopRetrigger.UnmetCondition' title: unmet_conditions type: array title: LoopRetrigger type: object gitpod.v1.UpdateRunnerAgentExecutionResponse: additionalProperties: false title: UpdateRunnerAgentExecutionResponse type: object gitpod.v1.EnvironmentStatus.EnvironmentURLs: additionalProperties: false properties: logs: description: logs is the URL at which the environment logs can be accessed. title: logs type: string ops: description: ops is the URL at which the environment ops service can be accessed. title: ops type: string ports: items: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.EnvironmentPortURL' title: ports type: array ssh: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.EnvironmentSSHURL' description: SSH is the URL at which the environment can be accessed via SSH. title: ssh supportBundle: description: support_bundle is the URL at which the environment support bundle can be accessed. title: support_bundle type: string vmLiveUsage: description: vm_live_usage is the URL at which the environment's live VM resource usage can be accessed. title: vm_live_usage type: string x-stainless-skip: true title: EnvironmentURLs type: object gitpod.v1.ListRunnerLLMIntegrationsResponse: additionalProperties: false properties: llmIntegrations: description: The LLM integrations configured for the runner items: $ref: '#/components/schemas/gitpod.v1.LLMIntegration' title: llm_integrations type: array pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination options for listing LLM integrations title: pagination title: ListRunnerLLMIntegrationsResponse type: object gitpod.v1.CallImprovePromptForAgent.Response: additionalProperties: false properties: improvedPrompt: title: improved_prompt type: string title: Response type: object gitpod.v1.FieldValue: additionalProperties: false properties: key: title: key type: string value: title: value type: string title: FieldValue type: object gitpod.v1.ListRunnerWarmPoolsRequest: additionalProperties: false properties: pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing warm pools title: pagination runnerId: description: The runner's identity format: uuid title: runner_id type: string required: - runnerId title: ListRunnerWarmPoolsRequest type: object gitpod.v1.EnvironmentSpec.Secret.CredentialProxy: additionalProperties: false description: "CredentialProxy describes how the credential proxy should inject this\n secret into outgoing HTTPS requests." properties: format: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.Secret.CredentialProxy.Format' description: "format describes how the secret value is encoded. The proxy uses\n this to decode the value before injecting it into the header." title: format header: description: header is the HTTP header name to inject (e.g. "Authorization"). title: header type: string targetHosts: description: "target_hosts lists the hostnames to intercept (for example\n \"github.com\" or \"*.github.com\"). Wildcards are subdomain-only and\n do not match the apex domain." items: type: string title: target_hosts type: array title: CredentialProxy type: object gitpod.v1.ListRunnerWarmPoolsResponse: additionalProperties: false properties: pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination response title: pagination warmPools: items: $ref: '#/components/schemas/gitpod.v1.WarmPool' title: warm_pools type: array title: ListRunnerWarmPoolsResponse type: object google.protobuf.Duration: description: "A Duration represents a signed, fixed-length span of time represented\n as a count of seconds and fractions of seconds at nanosecond\n resolution. It is independent of any calendar and concepts like \"day\"\n or \"month\". It is related to Timestamp in that the difference between\n two Timestamp values is a Duration and it can be added or subtracted\n from a Timestamp. Range is approximately +-10,000 years.\n\n # Examples\n\n Example 1: Compute Duration from two Timestamps in pseudo code.\n\n Timestamp start = ...;\n Timestamp end = ...;\n Duration duration = ...;\n\n duration.seconds = end.seconds - start.seconds;\n duration.nanos = end.nanos - start.nanos;\n\n if (duration.seconds < 0 && duration.nanos > 0) {\n duration.seconds += 1;\n duration.nanos -= 1000000000;\n } else if (duration.seconds > 0 && duration.nanos < 0) {\n duration.seconds -= 1;\n duration.nanos += 1000000000;\n }\n\n Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.\n\n Timestamp start = ...;\n Duration duration = ...;\n Timestamp end = ...;\n\n end.seconds = start.seconds + duration.seconds;\n end.nanos = start.nanos + duration.nanos;\n\n if (end.nanos < 0) {\n end.seconds -= 1;\n end.nanos += 1000000000;\n } else if (end.nanos >= 1000000000) {\n end.seconds += 1;\n end.nanos -= 1000000000;\n }\n\n Example 3: Compute Duration from datetime.timedelta in Python.\n\n td = datetime.timedelta(days=3, minutes=10)\n duration = Duration()\n duration.FromTimedelta(td)\n\n # JSON Mapping\n\n In JSON format, the Duration type is encoded as a string rather than an\n object, where the string ends in the suffix \"s\" (indicating seconds) and\n is preceded by the number of seconds, with nanoseconds expressed as\n fractional seconds. For example, 3 seconds with 0 nanoseconds should be\n encoded in JSON format as \"3s\", while 3 seconds and 1 nanosecond should\n be expressed in JSON format as \"3.000000001s\", and 3 seconds and 1\n microsecond should be expressed in JSON format as \"3.000001s\"." format: regex pattern: ^[-\+]?([0-9]+\.?[0-9]*|\.[0-9]+)s$ type: string gitpod.v1.UpdateRunnerEnvironmentStatusRequest: additionalProperties: false properties: environmentId: description: The environment's ID format: uuid title: environment_id type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string status: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus' description: The environment's status title: status title: UpdateRunnerEnvironmentStatusRequest type: object gitpod.v1.GetLatestVersionResponse.GcpManifest: additionalProperties: false properties: downloadUrl: description: Download URL for the terraform files. title: download_url type: string proxyImage: description: "The container image of the proxy.\n Will only be set if the latest release in the release channel has the same infrastructure version as the runner." title: proxy_image type: string runnerImage: description: "The container image of the runner.\n Will only be set if the latest release in the release channel has the same infrastructure version as the runner." title: runner_image type: string terraformFiles: description: Terraform files to be used to create the runner. items: type: string title: terraform_files type: array title: GcpManifest type: object gitpod.v1.LLMIntegration: additionalProperties: false properties: encryptedApiKey: description: encrypted_api_key is the LLM provider's API key encrypted with the runner's public key. format: byte title: encrypted_api_key type: string endpoint: title: endpoint type: string id: description: id is the unique identifier of the LLM integration title: id type: string maxTokens: description: the maximum number of tokens to generate before stopping. 0 is a model default. title: max_tokens type: string models: description: models represents the supported LLM models for this integration items: $ref: '#/components/schemas/gitpod.v1.SupportedModel' title: models type: array phase: $ref: '#/components/schemas/gitpod.v1.LLMIntegrationPhase' description: phase represents the current status/phase of the LLM integration title: phase phaseReason: description: phase_reason provides explanation for the current phase (e.g., "insufficient funds", "user disabled") title: phase_reason type: string requestHeaders: description: request_headers contains optional headers for the LLM integration. items: $ref: '#/components/schemas/gitpod.v1.LLMIntegrationRequestHeader' title: request_headers type: array runnerId: title: runner_id type: string title: LLMIntegration type: object gitpod.v1.RunnerConfigurationSchema: additionalProperties: false properties: environmentClasses: items: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.Field' title: environment_classes type: array runnerConfig: items: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.Field' title: runner_config type: array scm: items: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.SCMConfigSchema' title: scm type: array version: description: The schema version title: version type: string title: RunnerConfigurationSchema type: object gitpod.v1.AgentCodeContext.ContextURL: additionalProperties: false properties: environmentClassId: format: uuid title: environment_class_id type: string url: format: uri title: url type: string title: ContextURL type: object gitpod.v1.ListManagedRunnersResponse: additionalProperties: false properties: pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination options for listing managed runners title: pagination runners: description: The managed runners items: $ref: '#/components/schemas/gitpod.v1.ManagedRunner' title: runners type: array title: ListManagedRunnersResponse type: object gitpod.v1.MarkRunnerActiveResponse: additionalProperties: false title: MarkRunnerActiveResponse type: object gitpod.v1.AgentExecution.Status.EnvironmentUsage: additionalProperties: false properties: createdByAgent: title: created_by_agent type: boolean environmentId: format: uuid title: environment_id type: string title: EnvironmentUsage type: object gitpod.v1.WakeEvent: additionalProperties: false description: "WakeEvent is sent by the backend to wake an agent when a registered interest fires.\n Delivered via SendToAgentExecution as a new oneof variant." oneOf: - not: anyOf: - required: - loopRetrigger - required: - timer required: - environment - not: anyOf: - required: - environment - required: - timer required: - loopRetrigger - not: anyOf: - required: - environment - required: - loopRetrigger required: - timer properties: environment: $ref: '#/components/schemas/gitpod.v1.WakeEvent.EnvironmentPhaseReached' title: environment interestId: description: The interest ID that fired (from WaitingInfo.Interest.id). title: interest_id type: string loopRetrigger: $ref: '#/components/schemas/gitpod.v1.WakeEvent.LoopRetrigger' title: loop_retrigger timer: $ref: '#/components/schemas/gitpod.v1.WakeEvent.TimerFired' title: timer title: WakeEvent type: object gitpod.v1.IntegrationSourceCodeAccessCapability: additionalProperties: false description: IntegrationSourceCodeAccessCapability defines source code access capability Additional source code access configuration can be added here title: IntegrationSourceCodeAccessCapability type: object gitpod.v1.KernelControlsConfig: additionalProperties: false description: KernelControlsConfig configures kernel-level controls for the environment properties: bpfDebugLevel: $ref: '#/components/schemas/gitpod.v1.BPFDebugLevel' description: "bpf_debug_level controls the verbosity of BPF trace_pipe output\n for all BPF-based agents in this environment." title: bpf_debug_level x-stainless-skip: true veto: $ref: '#/components/schemas/gitpod.v1.Veto' description: veto controls blocking mechanisms title: veto title: KernelControlsConfig type: object gitpod.v1.EnvironmentSpec.SSHPublicKey: additionalProperties: false properties: id: description: id is the unique identifier of the public key title: id type: string value: description: value is the actual public key in the public key file format title: value type: string title: SSHPublicKey type: object gitpod.v1.EnvironmentActivitySignal: additionalProperties: false description: EnvironmentActivitySignal used to signal activity for an environment. properties: source: description: "source of the activity signal, such as \"VS Code\", \"SSH\", or \"Automations\".\n It should be a human-readable string that describes the source of the activity signal." maxLength: 80 minLength: 3 title: source type: string timestamp: $ref: '#/components/schemas/google.protobuf.Timestamp' description: "timestamp of when the activity was observed by the source.\n Only reported every 5 minutes.\n Zero value means no activity was observed." title: timestamp title: EnvironmentActivitySignal type: object gitpod.v1.PullRequest.Repository: additionalProperties: false description: Repository information properties: cloneUrl: title: clone_url type: string host: title: host type: string name: title: name type: string owner: title: owner type: string title: Repository type: object gitpod.v1.ListRunnerLLMIntegrationsRequest.Filter: additionalProperties: false properties: supportedModels: description: supported_models filters the response to only LLM integrations with these models items: $ref: '#/components/schemas/gitpod.v1.SupportedModel' maxItems: 25 title: supported_models type: array title: Filter type: object gitpod.v1.IntegrationCapabilities: additionalProperties: false description: IntegrationCapabilities defines what an integration can do properties: agentClient: $ref: '#/components/schemas/gitpod.v1.IntegrationAgentClientCapability' description: agent_client configuration for agent client functionality support title: agent_client contextParsing: $ref: '#/components/schemas/gitpod.v1.IntegrationContextParsingCapability' description: context_parsing configuration for context parsing support title: context_parsing login: $ref: '#/components/schemas/gitpod.v1.IntegrationLoginCapability' description: login configuration for login/authentication support title: login mcp: $ref: '#/components/schemas/gitpod.v1.IntegrationMCPCapability' description: mcp configuration for Model Context Protocol support title: mcp sourceCodeAccess: $ref: '#/components/schemas/gitpod.v1.IntegrationSourceCodeAccessCapability' description: source_code_access configuration for source code access support title: source_code_access title: IntegrationCapabilities type: object gitpod.v1.AgentCodeContext: additionalProperties: false oneOf: - not: anyOf: - required: - environmentId - required: - projectId required: - contextUrl - not: anyOf: - required: - contextUrl - required: - projectId required: - environmentId - not: anyOf: - required: - contextUrl - required: - environmentId required: - projectId properties: contextUrl: $ref: '#/components/schemas/gitpod.v1.AgentCodeContext.ContextURL' title: context_url environmentId: format: uuid title: environment_id type: string projectId: format: uuid title: project_id type: string pullRequest: $ref: '#/components/schemas/gitpod.v1.PullRequest' description: "Pull request context - optional metadata about the PR being worked on\n This is populated when the agent execution is triggered by a PR workflow\n or when explicitly provided through the browser extension" nullable: true title: pull_request title: AgentCodeContext type: object gitpod.v1.RunnerConfigurationSchema.BoolField: additionalProperties: false properties: default: title: default type: boolean title: BoolField type: object gitpod.v1.WakeEvent.TimerFired: additionalProperties: false properties: firedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: The actual time the timer was evaluated as expired. title: fired_at title: TimerFired type: object gitpod.v1.LLMIntegrationPhase: description: LLMIntegrationPhase represents the current status/phase of an LLM integration enum: - LLM_INTEGRATION_PHASE_UNSPECIFIED - LLM_INTEGRATION_PHASE_AVAILABLE - LLM_INTEGRATION_PHASE_UNAVAILABLE - LLM_INTEGRATION_PHASE_DISABLED title: LLMIntegrationPhase type: string gitpod.v1.RunnerEnvironmentSnapshot: additionalProperties: false properties: id: description: ID is a unique identifier of this snapshot title: id type: string metadata: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshotMetadata' description: Metadata is data associated with this snapshot title: metadata spec: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshotSpec' description: Spec is the configuration used to create this snapshot title: spec status: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshotStatus' description: Status is the current status of the snapshot title: status title: RunnerEnvironmentSnapshot type: object gitpod.v1.CallCheckRepositoryAccess.Response: additionalProperties: false properties: resp: $ref: '#/components/schemas/gitpod.v1.CheckRepositoryAccessResponse' title: resp title: Response type: object gitpod.v1.MCPIntegrationPhase: description: MCPIntegrationPhase represents the status of an MCP integration connection enum: - MCP_INTEGRATION_PHASE_UNSPECIFIED - MCP_INTEGRATION_PHASE_INITIALIZING - MCP_INTEGRATION_PHASE_READY - MCP_INTEGRATION_PHASE_FAILED - MCP_INTEGRATION_PHASE_UNAVAILABLE title: MCPIntegrationPhase type: string gitpod.v1.SupportedModel: enum: - 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_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_HAIKU_4_5 - SUPPORTED_MODEL_OPENAI_4O - SUPPORTED_MODEL_OPENAI_4O_MINI - SUPPORTED_MODEL_OPENAI_O1 - SUPPORTED_MODEL_OPENAI_O1_MINI title: SupportedModel type: string gitpod.v1.EnvironmentSpec.Content: additionalProperties: false properties: gitEmail: description: The Git email address title: git_email type: string gitUsername: description: The Git username title: git_username type: string initializer: $ref: '#/components/schemas/gitpod.v1.EnvironmentInitializer' description: initializer configures how the environment is to be initialized title: initializer session: title: session type: string title: Content type: object gitpod.v1.GetRunnerEnvironmentSnapshotRequest: additionalProperties: false properties: runnerId: description: The runner's identity format: uuid title: runner_id type: string snapshotId: description: snapshot_id specifies the snapshot to retrieve format: uuid title: snapshot_id type: string required: - runnerId - snapshotId title: GetRunnerEnvironmentSnapshotRequest type: object gitpod.v1.EnvironmentGitStatus: additionalProperties: false properties: branch: description: branch is branch we're currently on title: branch type: string changedFiles: description: "changed_files is an array of changed files in the environment, possibly\n truncated" items: $ref: '#/components/schemas/gitpod.v1.FileChange' maxItems: 101 title: changed_files type: array cloneUrl: description: "clone_url is the repository url as you would pass it to \"git clone\".\n Only HTTPS clone URLs are supported." title: clone_url type: string latestCommit: description: latest_commit is the most recent commit on the current branch title: latest_commit type: string totalChangedFiles: format: int32 title: total_changed_files type: integer totalUnpushedCommits: description: the total number of unpushed changes format: int32 title: total_unpushed_commits type: integer unpushedCommits: description: "unpushed_commits is an array of unpushed changes in the environment, possibly\n truncated" items: maxItems: 101 type: string maxItems: 101 title: unpushed_commits type: array title: EnvironmentGitStatus type: object gitpod.v1.ParseContextURLResponse.PullRequest: additionalProperties: false description: 'Deprecated: Use top-level PullRequest message instead' properties: fromBranch: title: from_branch type: string id: title: id type: string title: title: title type: string toBranch: title: to_branch type: string title: PullRequest type: object gitpod.v1.CallPing.Response: additionalProperties: false title: Response type: object gitpod.v1.ReportRunnerMetricsResponse: additionalProperties: false title: ReportRunnerMetricsResponse type: object gitpod.v1.AgentExecution.WaitingInfo.UserMessageInterest: additionalProperties: false title: UserMessageInterest type: object gitpod.v1.CallSearchRepositories.Response: additionalProperties: false properties: lastPage: description: 'Deprecated: Use pagination token instead. Total pages can be extracted from token.' format: int32 title: last_page type: integer pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: "Pagination information for the response.\n Token format: \"NEXT_PAGE/TOTAL_PAGES/TOTAL_COUNT\" (e.g., \"2/40/1000\").\n Use -1 for unknown values (e.g., \"2/-1/-1\" when totals unavailable).\n Empty token means no more pages." title: pagination repositories: description: List of repositories matching the search criteria items: $ref: '#/components/schemas/gitpod.v1.SearchRepositoriesResponse.Repository' title: repositories type: array title: Response type: object gitpod.v1.RunnerConfigurationSchema.SCMConfigSchema: additionalProperties: false properties: defaultHosts: items: type: string title: default_hosts type: array name: title: name type: string oauth: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.OAuth' title: oauth pat: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.PersonalAccessToken' title: pat scmId: title: scm_id type: string title: SCMConfigSchema type: object gitpod.v1.GetRunnerLLMIntegrationResponse: additionalProperties: false properties: llmIntegration: $ref: '#/components/schemas/gitpod.v1.LLMIntegration' title: llm_integration title: GetRunnerLLMIntegrationResponse type: object gitpod.v1.EventSnapshotSpecChange: additionalProperties: false properties: snapshotId: description: The snapshot's ID format: uuid title: snapshot_id type: string title: EventSnapshotSpecChange type: object gitpod.v1.AgentExecution.WaitingInfo: additionalProperties: false description: WaitingInfo describes what an agent is waiting for when in PHASE_WAITING_FOR_INPUT. properties: interests: items: $ref: '#/components/schemas/gitpod.v1.AgentExecution.WaitingInfo.Interest' title: interests type: array waitId: title: wait_id type: string waitingSince: $ref: '#/components/schemas/google.protobuf.Timestamp' title: waiting_since title: WaitingInfo type: object gitpod.v1.RunnerConfigurationSchema.OAuth: additionalProperties: false properties: callbackUrl: description: callback_url is the URL the OAuth app will redirect to after the user has authenticated. title: callback_url type: string title: OAuth type: object gitpod.v1.IntegrationContextParsingCapability: additionalProperties: false description: IntegrationContextParsingCapability defines context parsing capability Additional context parsing configuration can be added here title: IntegrationContextParsingCapability type: object gitpod.v1.AgentExecution.Status: additionalProperties: false properties: cachedCreationTokensUsed: title: cached_creation_tokens_used type: string cachedInputTokensUsed: title: cached_input_tokens_used type: string contextWindowLength: title: context_window_length type: string conversationUrl: description: conversation_url is the URL to the conversation (all messages exchanged between the agent and the user) of the agent run. title: conversation_url type: string currentActivity: description: current_activity is the current activity description of the agent execution. title: current_activity type: string currentOperation: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status.CurrentOperation' description: current_operation is the current operation of the agent execution. title: current_operation failureMessage: description: failure_message contains the reason the agent run failed to operate. title: failure_message type: string failureReason: $ref: '#/components/schemas/gitpod.v1.AgentExecutionFailureReason' description: failure_reason contains a structured reason code for the failure. title: failure_reason inputTokensUsed: title: input_tokens_used type: string iterations: title: iterations type: string judgement: description: judgement is the judgement of the agent run produced by the judgement prompt. title: judgement type: string loopConditionResults: items: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status.LoopConditionResult' title: loop_condition_results type: array x-stainless-skip: true mcpIntegrationStatuses: description: mcp_integration_statuses contains the status of all MCP integrations used by this agent execution items: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status.MCPIntegrationStatus' title: mcp_integration_statuses type: array mode: $ref: '#/components/schemas/gitpod.v1.AgentMode' description: "mode is the current operational mode of the agent execution.\n This is set by the agent when entering different modes (e.g., Ralph mode via /ona:ralph command)." title: mode outputTokensUsed: title: output_tokens_used type: string outputs: additionalProperties: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status.OutputValue' title: value description: "outputs is a map of key-value pairs that can be set by the agent during execution.\n Similar to task execution outputs, but with typed values for structured data." title: outputs type: object phase: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Phase' title: phase session: title: session type: string statusVersion: description: "version of the status. The value of this field has no semantic\n meaning (e.g. don't interpret it as as a timestamp),\n but it can be used to impose a partial order. If a.status_version <\n b.status_version then a was the status before b." title: status_version type: string supportBundleUrl: description: support_bundle_url is the URL to download a diagnostic bundle for this agent execution. title: support_bundle_url type: string x-stainless-skip: true supportedModel: $ref: '#/components/schemas/gitpod.v1.SupportedModel' description: supported_model is the LLM model being used by the agent execution. title: supported_model terminalId: description: 'terminal_id is the ID of the terminal running the agent, if the agent runs as a terminal service (runsOn: terminal).' title: terminal_id type: string x-stainless-skip: true transcriptUrl: description: transcript_url is the URL to the LLM transcript (all messages exchanged between the agent and the LLM) of the agent run. title: transcript_url type: string usedEnvironments: description: used_environments is the list of environments that were used by the agent execution. items: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status.EnvironmentUsage' title: used_environments type: array waitingInfo: $ref: '#/components/schemas/gitpod.v1.AgentExecution.WaitingInfo' description: "waiting_info is set when phase is PHASE_WAITING_FOR_INPUT and the agent\n has registered interests (timers, sub-agent completions, user messages)." title: waiting_info x-stainless-skip: true warningMessage: description: warning_message contains warnings, e.g. when the LLM is overloaded. title: warning_message type: string title: Status type: object gitpod.v1.Principal: enum: - PRINCIPAL_UNSPECIFIED - PRINCIPAL_ACCOUNT - PRINCIPAL_USER - PRINCIPAL_RUNNER - PRINCIPAL_ENVIRONMENT - PRINCIPAL_SERVICE_ACCOUNT - PRINCIPAL_RUNNER_MANAGER title: Principal type: string gitpod.v1.EnvironmentSpec.EnvironmentPort.Protocol: description: Protocol describes the communication protocol between Gateway and user environment services. enum: - PROTOCOL_UNSPECIFIED - PROTOCOL_HTTP - PROTOCOL_HTTPS title: Protocol type: string gitpod.v1.EventSCMIntegrationChange: additionalProperties: false properties: scmIntegrationId: description: The SCM integration's ID format: uuid title: scm_integration_id type: string title: EventSCMIntegrationChange type: object gitpod.v1.CallSendMessageToAgentExecution.Request: additionalProperties: false oneOf: - not: anyOf: - required: - message - required: - wakeEvent required: - agentMessage - not: anyOf: - required: - agentMessage - required: - wakeEvent required: - message - not: anyOf: - required: - agentMessage - required: - message required: - wakeEvent properties: agentExecutionId: title: agent_execution_id type: string agentMessage: $ref: '#/components/schemas/gitpod.v1.AgentMessage' title: agent_message message: $ref: '#/components/schemas/gitpod.v1.UserInputBlock' title: message wakeEvent: $ref: '#/components/schemas/gitpod.v1.WakeEvent' title: wake_event title: Request type: object gitpod.v1.EnvironmentSpec.EnvironmentPort: additionalProperties: false properties: admission: $ref: '#/components/schemas/gitpod.v1.AdmissionLevel' description: policy of this port title: admission authNonce: description: "auth_nonce is a monotonically increasing counter incremented by the\n backend whenever the port's admission level changes. Used by the proxy\n to invalidate browser auth cookies without requiring a backend round-trip." title: auth_nonce type: string x-stainless-skip: true name: description: name of this port maxLength: 100 minLength: 1 title: name type: string port: description: port number format: int32 maximum: 65535 minimum: 1024 title: port type: integer protocol: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.EnvironmentPort.Protocol' description: "protocol for communication (Gateway proxy → user environment service).\n this setting only affects the protocol used between Gateway and user environment services." title: protocol title: EnvironmentPort type: object gitpod.v1.UserInputBlock.TextInput: additionalProperties: false properties: content: minLength: 1 title: content type: string title: TextInput type: object gitpod.v1.RunnerConfigurationSchema.IntField: additionalProperties: false properties: default: format: int32 title: default type: integer max: format: int32 title: max type: integer min: format: int32 title: min type: integer title: IntField type: object gitpod.v1.EnvironmentStatus.RunnerACK: additionalProperties: false description: "RunnerACK is the acknowledgement from the runner that is has received the\n environment spec." properties: message: title: message type: string specVersion: title: spec_version type: string statusCode: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.RunnerACK.StatusCode' title: status_code title: RunnerACK type: object gitpod.v1.PullRequest.State: description: Current state of the pull request enum: - STATE_UNSPECIFIED - STATE_OPEN - STATE_CLOSED - STATE_MERGED title: State type: string gitpod.v1.GitInitializer.CloneTargetMode: description: "CloneTargetMode is the target state in which we want to leave a\n GitEnvironment" enum: - CLONE_TARGET_MODE_UNSPECIFIED - CLONE_TARGET_MODE_REMOTE_HEAD - CLONE_TARGET_MODE_REMOTE_COMMIT - CLONE_TARGET_MODE_REMOTE_BRANCH - CLONE_TARGET_MODE_LOCAL_BRANCH - CLONE_TARGET_MODE_REMOTE_TAG title: CloneTargetMode type: string gitpod.v1.UpdateRunnerStatusResponse: additionalProperties: false title: UpdateRunnerStatusResponse type: object gitpod.v1.SendResponseRequest: additionalProperties: false oneOf: - not: anyOf: - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - error required: - callCheckAuthenticationForHost - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - error required: - callCheckRepositoryAccess - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - error required: - callImprovePromptForAgent - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - error required: - callListScmOrganizations - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - error required: - callParseContext - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - error required: - callPing - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - error required: - callSearchRepositories - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callValidateConfig - required: - error required: - callSendMessageToAgentExecution - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - error required: - callValidateConfig - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig required: - error properties: callCheckAuthenticationForHost: $ref: '#/components/schemas/gitpod.v1.CallCheckAuthenticationForHost.Response' title: call_check_authentication_for_host callCheckRepositoryAccess: $ref: '#/components/schemas/gitpod.v1.CallCheckRepositoryAccess.Response' title: call_check_repository_access callImprovePromptForAgent: $ref: '#/components/schemas/gitpod.v1.CallImprovePromptForAgent.Response' title: call_improve_prompt_for_agent callListScmOrganizations: $ref: '#/components/schemas/gitpod.v1.CallListSCMOrganizations.Response' title: call_list_scm_organizations callParseContext: $ref: '#/components/schemas/gitpod.v1.CallParseContext.Response' title: call_parse_context callPing: $ref: '#/components/schemas/gitpod.v1.CallPing.Response' title: call_ping callSearchRepositories: $ref: '#/components/schemas/gitpod.v1.CallSearchRepositories.Response' title: call_search_repositories callSendMessageToAgentExecution: $ref: '#/components/schemas/gitpod.v1.CallSendMessageToAgentExecution.Response' title: call_send_message_to_agent_execution callValidateConfig: $ref: '#/components/schemas/gitpod.v1.CallValidateConfig.Response' title: call_validate_config error: $ref: '#/components/schemas/gitpod.v1.SendResponseRequest.CallError' title: error requestId: description: The request's ID we're responding to format: uuid title: request_id type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string title: SendResponseRequest type: object gitpod.v1.GetRunnerEnvironmentSnapshotResponse: additionalProperties: false properties: snapshot: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshot' title: snapshot required: - snapshot title: GetRunnerEnvironmentSnapshotResponse type: object gitpod.v1.ListRunnerSCMIntegrationsRequest.Filter: additionalProperties: false properties: scmIntegrationIds: description: environment_class_ids filters the response to only SCM integrations with these IDs items: format: uuid maxItems: 25 type: string maxItems: 25 title: scm_integration_ids type: array title: Filter type: object gitpod.v1.EventWarmPoolSpecChange: additionalProperties: false properties: warmPoolId: description: The warm pool's ID format: uuid title: warm_pool_id type: string title: EventWarmPoolSpecChange type: object gitpod.v1.AgentExecution.Spec.LoopCondition: additionalProperties: false properties: description: title: description type: string expression: title: expression type: string id: title: id type: string title: LoopCondition type: object gitpod.v1.WatchManagedRunnersRequest: additionalProperties: false properties: empty: type: boolean title: WatchManagedRunnersRequest type: object gitpod.v1.BigPaginationRequest: additionalProperties: false description: Do not use this in user facing APIs unless you have a good reason for that properties: pageSize: description: "Page size is the maximum number of results to retrieve per page.\n Defaults to 25. Maximum 10000." format: int32 maximum: 10000 title: page_size type: integer token: description: "Token for the next set of results that was returned as next_token of a\n PaginationResponse" title: token type: string title: BigPaginationRequest type: object gitpod.v1.AgentExecution.Status.CurrentOperation: additionalProperties: false oneOf: - not: anyOf: - required: - toolUse required: - llm - not: anyOf: - required: - llm required: - toolUse properties: llm: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status.LLM' title: llm retries: description: retries is the number of times the agent run has retried one or more steps title: retries type: string session: title: session type: string toolUse: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status.ToolUse' title: tool_use title: CurrentOperation type: object gitpod.v1.RunnerEnvironment: additionalProperties: false properties: activitySignal: $ref: '#/components/schemas/gitpod.v1.EnvironmentActivitySignal' description: The last activity signal received by the management plane title: activity_signal environmentAccessToken: description: The environment's access token title: environment_access_token type: string id: description: "ID is a unique identifier of this environment. No other environment with the same name must be managed by this\n environment manager" format: uuid title: id type: string metadata: $ref: '#/components/schemas/gitpod.v1.EnvironmentMetadata' description: Metadata is data associated with this environment that's required for other parts of Gitpod to function title: metadata scmContexts: description: The SCM contexts for the environment items: $ref: '#/components/schemas/gitpod.v1.SCMContext' title: scm_contexts type: array snapshotId: description: "snapshot_id specifies an existing environment snapshot to use when creating the environment.\n If present, the runner will attempt to use the referenced snapshot to create the environment,\n and otherwise fall back to normal environment creation." format: uuid title: snapshot_id type: string spec: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec' description: Spec is the configuration of the environment that's required for the runner to start the environment title: spec startupTraceContext: additionalProperties: title: value type: string description: "startup_trace_context contains trace headers for the root startup trace\n to propagate trace context to runners for end-to-end tracing" title: startup_trace_context type: object title: RunnerEnvironment type: object gitpod.v1.EnvironmentSpec.DevContainer.LifecycleStage: description: "LifecycleStage controls which devcontainer lifecycle commands are executed.\n See https://containers.dev/implementors/json_reference/#lifecycle-scripts" enum: - LIFECYCLE_STAGE_UNSPECIFIED - LIFECYCLE_STAGE_FULL - LIFECYCLE_STAGE_PREBUILD title: LifecycleStage type: string gitpod.v1.WarmPoolMetadata: additionalProperties: false description: WarmPoolMetadata contains metadata about the warm pool properties: createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: created_at is when the warm pool was created title: created_at environmentClassId: description: environment_class_id is the environment class whose instances are warmed format: uuid title: environment_class_id type: string organizationId: description: organization_id is the ID of the organization that owns the warm pool format: uuid title: organization_id type: string projectId: description: project_id is the ID of the project this warm pool belongs to format: uuid title: project_id type: string runnerId: description: "runner_id is the runner that manages this warm pool.\n Derived from the environment class." format: uuid title: runner_id type: string updatedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: updated_at is when the warm pool was last updated title: updated_at required: - createdAt - updatedAt title: WarmPoolMetadata type: object gitpod.v1.WarmPoolStatus: additionalProperties: false description: WarmPoolStatus contains the current status of a warm pool as reported by the runner properties: desiredSize: description: "desired_size is the current target number of instances the autoscaler\n has decided on. Unlike running_instances, this value is stable and\n does not fluctuate as instances are claimed and backfilled." format: int32 title: desired_size type: integer failureMessage: description: failure_message contains details about why the warm pool is degraded or failed title: failure_message type: string phase: $ref: '#/components/schemas/gitpod.v1.WarmPoolPhase' description: phase is the current phase of the warm pool lifecycle title: phase runningInstances: description: "running_instances is the number of running warm instances in the pool,\n ready to be claimed for near-instant environment startup." format: int32 title: running_instances type: integer statusVersion: description: "status_version is incremented each time the status is updated.\n Used for optimistic concurrency control." title: status_version type: string stoppedInstances: description: "stopped_instances is the number of pre-provisioned but stopped instances\n in the pool. When a running instance is claimed, stopped instances are\n used to backfill the running pool faster than provisioning from scratch.\n Stopped instances only incur storage costs, allowing a larger total pool\n at lower cost than keeping all instances running." format: int32 title: stopped_instances type: integer required: - phase title: WarmPoolStatus type: object gitpod.v1.AgentExecution.Status.ToolUse: additionalProperties: false properties: complete: title: complete type: boolean toolName: minLength: 1 title: tool_name type: string title: ToolUse type: object gitpod.v1.ListRunnerAgentExecutionsRequest: additionalProperties: false properties: filter: $ref: '#/components/schemas/gitpod.v1.ListRunnerAgentExecutionsRequest.Filter' title: filter pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing agent executions title: pagination runnerId: format: uuid title: runner_id type: string title: ListRunnerAgentExecutionsRequest type: object gitpod.v1.WatchManagedRunnersResponse: additionalProperties: false properties: eventType: $ref: '#/components/schemas/gitpod.v1.WatchManagedRunnersResponse.EventType' description: The type of event that occurred title: event_type runnerId: description: The runner's ID format: uuid title: runner_id type: string title: WatchManagedRunnersResponse type: object gitpod.v1.AgentExecution.WaitingInfo.Interest: additionalProperties: false oneOf: - not: anyOf: - required: - subAgent - required: - timer - required: - userMessage required: - environment - not: anyOf: - required: - environment - required: - timer - required: - userMessage required: - subAgent - not: anyOf: - required: - environment - required: - subAgent - required: - userMessage required: - timer - not: anyOf: - required: - environment - required: - subAgent - required: - timer required: - userMessage properties: environment: $ref: '#/components/schemas/gitpod.v1.AgentExecution.WaitingInfo.EnvironmentInterest' title: environment id: title: id type: string subAgent: $ref: '#/components/schemas/gitpod.v1.AgentExecution.WaitingInfo.SubAgentInterest' title: sub_agent timer: $ref: '#/components/schemas/gitpod.v1.AgentExecution.WaitingInfo.TimerInterest' title: timer userMessage: $ref: '#/components/schemas/gitpod.v1.AgentExecution.WaitingInfo.UserMessageInterest' title: user_message title: Interest type: object connect.error: additionalProperties: true description: 'Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation' properties: code: description: The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. enum: - canceled - unknown - invalid_argument - deadline_exceeded - not_found - already_exists - permission_denied - resource_exhausted - failed_precondition - aborted - out_of_range - unimplemented - internal - unavailable - data_loss - unauthenticated example: - not_found type: string message: description: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. type: string title: Connect Error type: object gitpod.v1.GetLatestVersionResponse.LinuxHostManifest: additionalProperties: false properties: chRemoteStaticUrl: title: ch_remote_static_url type: string cloudHypervisorUrl: title: cloud_hypervisor_url type: string kernelImageUrl: title: kernel_image_url type: string linuxRunnerUrl: title: linux_runner_url type: string rootfsDiskImageUrl: title: rootfs_disk_image_url type: string sharedDiskImageUrl: title: shared_disk_image_url type: string zstdUrl: title: zstd_url type: string required: - linuxRunnerUrl - kernelImageUrl - rootfsDiskImageUrl - sharedDiskImageUrl - cloudHypervisorUrl - chRemoteStaticUrl - zstdUrl title: LinuxHostManifest type: object gitpod.v1.CallCheckAuthenticationForHost.Request: additionalProperties: false properties: host: title: host type: string principalId: title: principal_id type: string title: Request type: object gitpod.v1.EnvironmentMetadata: additionalProperties: false description: "EnvironmentMetadata is data associated with an environment that's required for\n other parts of the system to function" properties: annotations: additionalProperties: title: value type: string description: "annotations are key/value pairs that gets attached to the environment.\n +internal - not yet implemented" title: annotations type: object archivedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: Time when the Environment was archived. If not set, the environment is not archived. title: archived_at createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: Time when the Environment was created. title: created_at creator: $ref: '#/components/schemas/gitpod.v1.Subject' description: creator is the identity of the creator of the environment title: creator lastStartedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: Time when the Environment was last started (i.e. CreateEnvironment or StartEnvironment were called). title: last_started_at lockdownAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: "lockdown_at is the time at which the environment becomes locked down due\n to the organization's maximum environment lifetime policy. Nil when no\n lifetime policy applies." title: lockdown_at name: description: name is the name of the environment as specified by the user maxLength: 80 title: name type: string organizationId: description: organization_id is the ID of the organization that contains the environment format: uuid title: organization_id type: string originalContextUrl: description: "original_context_url is the normalized URL from which the environment was\n created" title: original_context_url type: string prebuildId: description: "prebuild_id is the ID of the prebuild this environment was created from.\n Only set if the environment was created from a prebuild." format: uuid nullable: true title: prebuild_id type: string projectId: description: If the Environment was started from a project, the project_id will reference the project. title: project_id type: string role: $ref: '#/components/schemas/gitpod.v1.EnvironmentRole' description: role is the role of the environment title: role runnerId: description: Runner is the ID of the runner that runs this environment. title: runner_id type: string sessionId: description: session_id is the ID of the session this environment belongs to. title: session_id type: string x-stainless-skip: true title: EnvironmentMetadata type: object gitpod.v1.IntegrationProprietaryAppConfig: additionalProperties: false description: "IntegrationProprietaryAppConfig defines proprietary application integration configuration.\n Used for app installations that interact with Ona (e.g., GitHub Apps, Linear agent apps)." properties: appId: description: "app_id is the application identifier assigned by the provider (e.g., GitHub App ID).\n Used to authenticate as the application itself." title: app_id type: string appScopes: description: "app_scopes are OAuth scopes to request when using app installation flows.\n If not set, falls back to the standard OAuth scopes." items: type: string title: app_scopes type: array appSlug: description: "app_slug is the URL-friendly identifier assigned by the provider (e.g., GitHub App slug).\n Used to construct installation URLs like https://github.com/apps/{app_slug}/installations/new." title: app_slug type: string authParams: additionalProperties: title: value type: string description: "auth_params are additional OAuth authorization parameters to include in the auth URL.\n Example: {\"actor\": \"app\"} for Linear agent installations." title: auth_params type: object clientId: description: client_id is the app client ID title: client_id type: string clientSecret: description: client_secret is the app client secret title: client_secret type: string privateKey: description: "private_key is the PEM-encoded private key used to sign JWTs for app authentication.\n This is sensitive and will be censored in API responses." title: private_key type: string tokenUrl: description: "token_url is the OAuth token exchange endpoint for app installation flows.\n If not set, falls back to the standard oauth.token_url.\n Slack requires a different token endpoint for app-level vs user-level flows." title: token_url type: string webhookSecret: description: webhook_secret is the secret used to verify webhook signatures from the app provider title: webhook_secret type: string title: IntegrationProprietaryAppConfig type: object gitpod.v1.RunnerConfigurationSchema.EnumField: additionalProperties: false properties: default: deprecated: true description: deprecated, will be removed, use default_value instead title: default type: string defaultValue: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.EnumField.Value' title: default_value possibleValues: items: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.EnumField.Value' title: possible_values type: array values: deprecated: true description: deprecated, will be removed, use possible_values instead items: deprecated: true type: string title: values type: array title: EnumField type: object gitpod.v1.GatewayInfo: additionalProperties: false properties: gateway: $ref: '#/components/schemas/gitpod.v1.Gateway' title: gateway latency: $ref: '#/components/schemas/google.protobuf.Duration' description: latency is the round-trip time of the runner to the gateway in milliseconds. title: latency title: GatewayInfo type: object gitpod.v1.ListRunnerEnvironmentClassesResponse: additionalProperties: false properties: environmentClasses: description: The environment classes configured for the runner items: $ref: '#/components/schemas/gitpod.v1.EnvironmentClass' title: environment_classes type: array pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination options for listing environment classes title: pagination title: ListRunnerEnvironmentClassesResponse type: object gitpod.v1.ListRunnerAgentExecutionsResponse: additionalProperties: false properties: agentExecutions: description: The agent ListRunnerAgentExecutionsRequest on the runner items: $ref: '#/components/schemas/gitpod.v1.RunnerAgentExecution' title: agent_executions type: array pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination options for listing agent executions title: pagination title: ListRunnerAgentExecutionsResponse type: object gitpod.v1.ListRunnerIntegrationsResponse: additionalProperties: false properties: integrations: description: The integrations configured for the runner items: $ref: '#/components/schemas/gitpod.v1.Integration' title: integrations type: array pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination options for listing integrations title: pagination title: ListRunnerIntegrationsResponse type: object gitpod.v1.SignupRequest: additionalProperties: false properties: environmentClasses: description: The environment classes this runner has to offer items: $ref: '#/components/schemas/gitpod.v1.EnvironmentClass' title: environment_classes type: array publicKey: description: The runner's public key. Must be an ECDH public key encoded in PKIX, ASN.1 DER format. format: byte maxLength: 32 minLength: 32 title: public_key type: string title: SignupRequest type: object gitpod.v1.CheckAuthenticationForHostResponse.AuthenticationMethodPersonalAccessToken: additionalProperties: false properties: createUrl: description: create_url is the URL where users can create a new Personal Access Token title: create_url type: string docsUrl: description: docs_url is the URL to the documentation explaining PAT usage for this host title: docs_url type: string example: description: example is an example of a Personal Access Token title: example type: string requiredScopes: description: required_scopes is the list of permissions required for the Personal Access Token items: type: string title: required_scopes type: array title: AuthenticationMethodPersonalAccessToken type: object gitpod.v1.RunnerMetricsConfiguration: additionalProperties: false properties: enabled: title: enabled type: boolean encryptedPassword: format: byte title: encrypted_password type: string encryptedUsername: format: byte title: encrypted_username type: string managedMetricsEnabled: description: "When true, the runner pushes metrics to the management plane via\n ReportRunnerMetrics instead of directly to the remote_write endpoint." title: managed_metrics_enabled type: boolean url: title: url type: string title: RunnerMetricsConfiguration type: object gitpod.v1.CallSearchRepositories.Request: additionalProperties: false properties: limit: deprecated: true description: "Maximum number of repositories to return.\n Deprecated: Use pagination.page_size instead" format: int32 title: limit type: integer pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: Pagination parameters for repository search title: pagination principalId: description: The principal's ID to search repositories for title: principal_id type: string scmHost: description: The SCM's host to search repositories for title: scm_host type: string searchMode: $ref: '#/components/schemas/gitpod.v1.SearchMode' description: Search mode determines how search_string is interpreted title: search_mode searchString: description: Search query - interpretation depends on search_mode title: search_string type: string title: Request type: object gitpod.v1.UpdateRunnerStatusRequest: additionalProperties: false properties: additionalInfo: description: additional_info updates fields in the runner's additional_info. items: $ref: '#/components/schemas/gitpod.v1.FieldValueUpdate' title: additional_info type: array capabilities: description: "capabilities contains the runner's supported capabilities.\n Optional field, only overwrites previous capabilities if set to a non-empty list.\n To clear capabilities, set this to a list with a single UNSPECIFIED capability." items: $ref: '#/components/schemas/gitpod.v1.RunnerCapability' title: capabilities type: array degredationMessage: description: "Degredation message is an optional message that is shown to users when the runner is in a degraded state.\n Setting this to \"\" changes the runner's phase back from \"degraded\" to \"active\"." nullable: true title: degredation_message type: string gatewayInfo: $ref: '#/components/schemas/gitpod.v1.GatewayInfo' description: GatewayInfo contains information about the gateway that the runner is running on. title: gateway_info llmUrl: description: llm_url is the URL of the LLM service to which the runner is connected. nullable: true title: llm_url type: string logUrl: description: log_url is the URL to the runner's logs format: uri nullable: true title: log_url type: string region: description: region is the region the runner is running in, if applicable. nullable: true title: region type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string supportBundleUrl: nullable: true title: support_bundle_url type: string systemDetails: description: "system_details is a runner specific system detail string. Think of this like a user agent string.\n It's intended to be used for debugging and support purposes and might be shown to the user." nullable: true title: system_details type: string version: description: version is the version of the runner. This is used to detect if the runner is outdated. nullable: true title: version type: string title: UpdateRunnerStatusRequest type: object gitpod.v1.AgentExecutionFailureReason: description: AgentExecutionFailureReason represents the reason why an agent execution failed enum: - AGENT_EXECUTION_FAILURE_REASON_UNSPECIFIED - AGENT_EXECUTION_FAILURE_REASON_ENVIRONMENT - AGENT_EXECUTION_FAILURE_REASON_SERVICE - AGENT_EXECUTION_FAILURE_REASON_LLM_INTEGRATION - AGENT_EXECUTION_FAILURE_REASON_INTERNAL - AGENT_EXECUTION_FAILURE_REASON_AGENT_EXECUTION title: AgentExecutionFailureReason type: string gitpod.v1.SendResponseResponse: additionalProperties: false title: SendResponseResponse type: object gitpod.v1.IntegrationMCPCapability: additionalProperties: false description: IntegrationMCPCapability defines Model Context Protocol capability properties: url: description: url is the remote server URL for the MCP server title: url type: string title: IntegrationMCPCapability type: object gitpod.v1.FileChange: additionalProperties: false properties: changeType: $ref: '#/components/schemas/gitpod.v1.FileChange.ChangeType' title: change_type path: description: path is the path of the file maxLength: 255 title: path type: string title: FileChange type: object gitpod.v1.EnvironmentSpec.Secret.CredentialProxy.Format: enum: - FORMAT_UNSPECIFIED - FORMAT_PLAIN - FORMAT_BASE64 title: Format type: string gitpod.v1.RunnerReleaseChannel: enum: - RUNNER_RELEASE_CHANNEL_UNSPECIFIED - RUNNER_RELEASE_CHANNEL_STABLE - RUNNER_RELEASE_CHANNEL_LATEST title: RunnerReleaseChannel type: string gitpod.v1.EnvironmentSpec.AutomationsFile: additionalProperties: false properties: automationsFilePath: description: "automations_file_path is the path to the automations file that is applied in the environment,\n relative to the repo root.\npath must not be absolute (start with a /):\n```\nthis.matches('^$|^[^/].*')\n```\n\n" title: automations_file_path type: string session: title: session type: string triggerFilter: description: "trigger_filter specifies which automation triggers should execute.\n When set, only automations matching these triggers will run.\n If empty/unset, all triggers are evaluated normally." items: $ref: '#/components/schemas/gitpod.v1.AutomationTrigger' title: trigger_filter type: array title: AutomationsFile type: object gitpod.v1.EventRunnerConfigurationChange: additionalProperties: false title: EventRunnerConfigurationChange type: object gitpod.v1.RunnerEnvironmentSnapshotStatus: additionalProperties: false description: SnapshotStatus describes the current status of a snapshot properties: completedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: completed_at is when the snapshot creation was completed (if successful) title: completed_at completionPercentage: description: progress contains information about snapshot creation progress format: int32 maximum: 100 title: completion_percentage type: integer failureMessage: description: failure_message contains details about why the snapshot failed title: failure_message type: string logsUrl: description: logs_url is the URL to access the environment logs for this snapshot title: logs_url type: string phase: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshotPhase' description: phase is the current phase of the snapshot lifecycle title: phase providerSnapshot: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshotStatus.ProviderSnapshot' description: provider_snapshot contains provider-specific snapshot details title: provider_snapshot sizeBytes: description: size_bytes is the size of the snapshot in bytes (available when completed) title: size_bytes type: string title: RunnerEnvironmentSnapshotStatus type: object gitpod.v1.CallValidateConfig.Request: additionalProperties: false oneOf: - not: anyOf: - required: - scm required: - environmentClass - not: anyOf: - required: - environmentClass required: - scm properties: environmentClass: $ref: '#/components/schemas/gitpod.v1.EnvironmentClass' title: environment_class scm: $ref: '#/components/schemas/gitpod.v1.SCMIntegration' title: scm title: Request type: object gitpod.v1.ListRunnerEnvironmentsResponse: additionalProperties: false properties: environments: description: The environments running on the runner items: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironment' title: environments type: array pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination options for listing environments title: pagination title: ListRunnerEnvironmentsResponse type: object gitpod.v1.AgentExecution.WaitingInfo.TimerInterest: additionalProperties: false properties: cron: description: cron is the cron expression, if cron-based. title: cron type: string duration: description: duration is the original duration spec (e.g. "5m"), if interval-based. title: duration type: string firesAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: fires_at is the next fire time. title: fires_at title: TimerInterest type: object gitpod.v1.AgentExecution.Status.OutputValue: additionalProperties: false oneOf: - not: anyOf: - required: - floatValue - required: - intValue - required: - stringValue required: - boolValue - not: anyOf: - required: - boolValue - required: - intValue - required: - stringValue required: - floatValue - not: anyOf: - required: - boolValue - required: - floatValue - required: - stringValue required: - intValue - not: anyOf: - required: - boolValue - required: - floatValue - required: - intValue required: - stringValue properties: boolValue: title: bool_value type: boolean floatValue: format: double title: float_value type: number intValue: title: int_value type: string stringValue: maxLength: 4096 title: string_value type: string title: OutputValue type: object gitpod.v1.AdmissionLevel: description: Admission level describes who can access an environment instance and its ports. enum: - ADMISSION_LEVEL_UNSPECIFIED - ADMISSION_LEVEL_OWNER_ONLY - ADMISSION_LEVEL_EVERYONE - ADMISSION_LEVEL_ORGANIZATION - ADMISSION_LEVEL_CREATOR_ONLY title: AdmissionLevel type: string gitpod.v1.EventLLMIntegrationChange: additionalProperties: false properties: llmIntegrationId: description: The LLM integration's ID format: uuid title: llm_integration_id type: string title: EventLLMIntegrationChange type: object gitpod.v1.AgentMessage.Role: description: Role identifies the sender's relationship in the parent/child hierarchy. enum: - ROLE_UNSPECIFIED - ROLE_PARENT - ROLE_CHILD title: Role type: string gitpod.v1.RunnerEnvironmentSnapshotMetadata: additionalProperties: false description: SnapshotMetadata contains metadata about the snapshot properties: createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: created_at is when the snapshot creation was initiated title: created_at environmentId: description: environment_id is the ID of the environment that was snapshotted format: uuid title: environment_id type: string environmentSpec: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec' description: environment_spec is the specification of the environment that was snapshotted title: environment_spec organizationId: description: organization_id is the ID of the organization that owns the snapshot format: uuid title: organization_id type: string projectId: description: project_id is the ID of the project that the snapshot belongs to format: uuid nullable: true title: project_id type: string runnerId: description: runner_id is the ID of the runner that created the snapshot format: uuid title: runner_id type: string required: - environmentSpec title: RunnerEnvironmentSnapshotMetadata type: object gitpod.v1.ReportLLMUsageResponse: additionalProperties: false title: ReportLLMUsageResponse type: object gitpod.v1.Veto.Exec: additionalProperties: false description: Exec controls executable blocking properties: action: $ref: '#/components/schemas/gitpod.v1.KernelControlsAction' description: action specifies what action kernel-level controls take on policy violations title: action denyBlockDevices: description: "deny_block_devices blocks opening of block devices (S_ISBLK) system-wide\n inside the environment. Prevents direct disk access. Gated by a feature flag." title: deny_block_devices type: boolean x-stainless-skip: true denylist: description: denylist is the list of executable paths or names to block items: type: string title: denylist type: array enabled: description: enabled controls whether executable blocking is active title: enabled type: boolean resolveBareNames: description: "resolve_bare_names enables the discovery agent to resolve bare executable\n names in the denylist to full filesystem paths. Gated by a feature flag\n for incremental rollout." title: resolve_bare_names type: boolean x-stainless-skip: true untouchable: description: "untouchable enables file I/O blocking on denylisted files. When true,\n every read()/write() on a denylisted file is blocked via the\n security_file_permission LSM hook. Gated by a feature flag." title: untouchable type: boolean x-stainless-skip: true watch: description: "watch enables the BPF file watcher that emits events when denylisted\n files are modified, unlinked, or renamed. Used by the self-healing\n responder to keep the hash denylist up to date." title: watch type: boolean x-stainless-skip: true title: Exec type: object gitpod.v1.HostAuthenticationTokenSource: enum: - HOST_AUTHENTICATION_TOKEN_SOURCE_UNSPECIFIED - HOST_AUTHENTICATION_TOKEN_SOURCE_OAUTH - HOST_AUTHENTICATION_TOKEN_SOURCE_PAT title: HostAuthenticationTokenSource type: string gitpod.v1.RunnerAgentExecution: additionalProperties: false properties: actorAccessToken: title: actor_access_token type: string agentExecution: $ref: '#/components/schemas/gitpod.v1.AgentExecution' title: agent_execution title: RunnerAgentExecution type: object gitpod.v1.EnvironmentSpec.Machine: additionalProperties: false properties: class: description: Class denotes the class of the environment we ought to start title: class type: string preferDualDisk: description: "prefer_dual_disk indicates the management plane wants this environment\n to use a dual-disk layout (separate system and data disks). The runner\n may ignore this if it does not support dual-disk." title: prefer_dual_disk type: boolean x-stainless-skip: true session: title: session type: string title: Machine type: object gitpod.v1.EnvironmentStatus.Machine.Phase: enum: - PHASE_UNSPECIFIED - PHASE_CREATING - PHASE_STARTING - PHASE_RUNNING - PHASE_STOPPING - PHASE_STOPPED - PHASE_DELETING - PHASE_DELETED title: Phase type: string gitpod.v1.GetRunnerConfigurationRequest: additionalProperties: false properties: runnerId: format: uuid title: runner_id type: string title: GetRunnerConfigurationRequest type: object gitpod.v1.CheckAuthenticationForHostResponse: additionalProperties: false properties: authenticated: title: authenticated type: boolean authenticationUrl: deprecated: true title: authentication_url type: string patSupported: deprecated: true title: pat_supported type: boolean scmId: description: scm_id is the unique identifier of the SCM provider title: scm_id type: string scmName: description: scm_name is the human-readable name of the SCM provider (e.g., "GitHub", "GitLab") title: scm_name type: string supportsOauth2: $ref: '#/components/schemas/gitpod.v1.CheckAuthenticationForHostResponse.AuthenticationMethodOAuth2' description: supports_oauth2 indicates that the host supports OAuth2 authentication title: supports_oauth2 supportsPat: $ref: '#/components/schemas/gitpod.v1.CheckAuthenticationForHostResponse.AuthenticationMethodPersonalAccessToken' description: supports_pat indicates that the host supports Personal Access Token authentication title: supports_pat title: CheckAuthenticationForHostResponse type: object gitpod.v1.RunnerEnvironmentSnapshotPhase: description: SnapshotPhase represents the lifecycle phase of a snapshot enum: - RUNNER_ENVIRONMENT_SNAPSHOT_PHASE_UNSPECIFIED - RUNNER_ENVIRONMENT_SNAPSHOT_PHASE_PENDING - RUNNER_ENVIRONMENT_SNAPSHOT_PHASE_CREATING - RUNNER_ENVIRONMENT_SNAPSHOT_PHASE_AVAILABLE - RUNNER_ENVIRONMENT_SNAPSHOT_PHASE_FAILED - RUNNER_ENVIRONMENT_SNAPSHOT_PHASE_DELETING - RUNNER_ENVIRONMENT_SNAPSHOT_PHASE_DELETED title: RunnerEnvironmentSnapshotPhase type: string gitpod.v1.AutomationTrigger: additionalProperties: false description: "An AutomationTrigger represents a trigger for an automation action.\n The `manual` field shows a start button in the UI for manually triggering the automation.\n The `post_machine_start` field indicates that the automation should be triggered after the machine has started, before the devcontainer is ready.\n This is used for machine-level services like security agents that need to start early.\n The `post_environment_start` field indicates that the automation should be triggered after the environment has started (devcontainer ready).\n The `post_devcontainer_start` field indicates that the automation should be triggered after the dev container has started.\n The `prebuild` field starts the automation during a prebuild of an environment. This phase does not have user secrets available.\n The `before_snapshot` field triggers the automation after all prebuild tasks complete but before the snapshot is taken.\n This is used for tasks that need to run last during prebuilds, such as IDE warmup.\n Note: The prebuild and before_snapshot triggers can only be used with tasks, not services." oneOf: - not: anyOf: - required: - manual - required: - postDevcontainerStart - required: - postEnvironmentStart - required: - postMachineStart - required: - prebuild required: - beforeSnapshot - not: anyOf: - required: - beforeSnapshot - required: - postDevcontainerStart - required: - postEnvironmentStart - required: - postMachineStart - required: - prebuild required: - manual - not: anyOf: - required: - beforeSnapshot - required: - manual - required: - postEnvironmentStart - required: - postMachineStart - required: - prebuild required: - postDevcontainerStart - not: anyOf: - required: - beforeSnapshot - required: - manual - required: - postDevcontainerStart - required: - postMachineStart - required: - prebuild required: - postEnvironmentStart - not: anyOf: - required: - beforeSnapshot - required: - manual - required: - postDevcontainerStart - required: - postEnvironmentStart - required: - prebuild required: - postMachineStart - not: anyOf: - required: - beforeSnapshot - required: - manual - required: - postDevcontainerStart - required: - postEnvironmentStart - required: - postMachineStart required: - prebuild properties: beforeSnapshot: title: before_snapshot type: boolean manual: title: manual type: boolean postDevcontainerStart: title: post_devcontainer_start type: boolean postEnvironmentStart: title: post_environment_start type: boolean postMachineStart: title: post_machine_start type: boolean prebuild: title: prebuild type: boolean title: AutomationTrigger type: object gitpod.v1.ReportRunnerMetricsRequest: additionalProperties: false properties: compressedMetrics: description: "Snappy-compressed Prometheus remote-write WriteRequest protobuf.\n Maximum 512 KB compressed." format: byte maxLength: 524288 title: compressed_metrics type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string required: - runnerId - compressedMetrics title: ReportRunnerMetricsRequest type: object gitpod.v1.AgentExecution.Status.LLM: additionalProperties: false properties: complete: title: complete type: boolean title: LLM type: object gitpod.v1.RunnerConfigurationSchema.StringField: additionalProperties: false properties: default: title: default type: string pattern: title: pattern type: string title: StringField type: object gitpod.v1.ReportLLMUsageRequest: additionalProperties: false properties: agentExecutionId: description: The agent execution ID if this usage is associated with an agent execution title: agent_execution_id type: string idempotencyKey: description: Idempotency key to prevent duplicate usage reports title: idempotency_key type: string llmIntegrationId: description: The LLM integration's ID format: uuid title: llm_integration_id type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string supportedModel: $ref: '#/components/schemas/gitpod.v1.SupportedModel' description: The model used for the LLM request title: supported_model usage: $ref: '#/components/schemas/gitpod.v1.LLMUsage' title: usage title: ReportLLMUsageRequest type: object gitpod.v1.GetManagedRunnerRequest: additionalProperties: false properties: runnerId: format: uuid title: runner_id type: string title: GetManagedRunnerRequest type: object gitpod.v1.UpdateRunnerWarmPoolStatusRequest: additionalProperties: false properties: runnerId: description: The runner's identity format: uuid title: runner_id type: string status: $ref: '#/components/schemas/gitpod.v1.WarmPoolStatus' description: status is the new status for the warm pool title: status warmPoolId: description: warm_pool_id specifies the warm pool to update format: uuid title: warm_pool_id type: string required: - runnerId - warmPoolId - status title: UpdateRunnerWarmPoolStatusRequest type: object gitpod.v1.AgentExecution.Status.LoopConditionResult: additionalProperties: false properties: conditionId: title: condition_id type: string iteration: format: int32 title: iteration type: integer lastEvaluatedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: last_evaluated_at met: title: met type: boolean title: LoopConditionResult type: object gitpod.v1.EnvironmentStatus.SSHPublicKey: additionalProperties: false properties: id: description: id is the unique identifier of the public key title: id type: string phase: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.ContentPhase' description: phase is the current phase of the public key title: phase title: SSHPublicKey type: object gitpod.v1.EnvironmentSpec.Timeout: additionalProperties: false description: Timeout configures the environment timeout properties: disconnected: $ref: '#/components/schemas/google.protobuf.Duration' description: "inacitivity is the maximum time of disconnection before the environment is\n stopped or paused. Minimum duration is 30 minutes. Set to 0 to disable.\nvalue must be 0s (disabled) or at least 1800s (30 minutes):\n```\nthis == duration('0s') || this >= duration('1800s')\n```\n\n" title: disconnected title: Timeout type: object gitpod.v1.RunnerEnvironmentSnapshotStatus.ProviderSnapshot: additionalProperties: false description: ProviderSnapshot contains provider-specific snapshot information properties: providerName: description: provider_name is the name of the cloud provider (e.g., "aws", "gcp", "azure") maxLength: 255 title: provider_name type: string providerSnapshotId: description: provider_snapshot_id is the ID assigned by the cloud provider title: provider_snapshot_id type: string region: description: region is the cloud provider region where the snapshot is stored maxLength: 255 title: region type: string title: ProviderSnapshot type: object gitpod.v1.SignupResponse: additionalProperties: false properties: runnerId: description: The runner's identity format: uuid title: runner_id type: string title: SignupResponse type: object gitpod.v1.CheckRepositoryAccessResponse: additionalProperties: false properties: errorMessage: description: "error_message provides details when access check fails.\n Empty when has_access is true." title: error_message type: string hasAccess: description: has_access indicates whether the principal has read access to the repository. title: has_access type: boolean title: CheckRepositoryAccessResponse type: object gitpod.v1.SCMIntegrationValidationResult: additionalProperties: false properties: hostError: nullable: true title: host_error type: string oauthError: nullable: true title: oauth_error type: string patError: nullable: true title: pat_error type: string scmIdError: nullable: true title: scm_id_error type: string valid: title: valid type: boolean title: SCMIntegrationValidationResult type: object gitpod.v1.RunnerConfigurationSchema.DisplayField: additionalProperties: false properties: default: title: default type: string title: DisplayField type: object gitpod.v1.EnvironmentInitializer.Spec: additionalProperties: false oneOf: - not: anyOf: - required: - git required: - contextUrl - not: anyOf: - required: - contextUrl required: - git properties: contextUrl: $ref: '#/components/schemas/gitpod.v1.ContextURLInitializer' title: context_url git: $ref: '#/components/schemas/gitpod.v1.GitInitializer' title: git title: Spec type: object gitpod.v1.EnvironmentSpec.DevContainer.Dotfiles: additionalProperties: false properties: repository: description: URL of a dotfiles Git repository (e.g. https://github.com/owner/repository) format: uri title: repository type: string required: - repository title: Dotfiles type: object gitpod.v1.RunnerConfigurationSchema.Field: additionalProperties: false oneOf: - not: anyOf: - required: - display - required: - enum - required: - int - required: - string required: - bool - not: anyOf: - required: - bool - required: - enum - required: - int - required: - string required: - display - not: anyOf: - required: - bool - required: - display - required: - int - required: - string required: - enum - not: anyOf: - required: - bool - required: - display - required: - enum - required: - string required: - int - not: anyOf: - required: - bool - required: - display - required: - enum - required: - int required: - string properties: bool: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.BoolField' title: bool description: title: description type: string display: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.DisplayField' title: display enum: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.EnumField' title: enum id: title: id type: string int: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.IntField' title: int name: title: name type: string required: title: required type: boolean secret: title: secret type: boolean string: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema.StringField' title: string title: Field type: object gitpod.v1.GetHostAuthenticationTokenValueRequest: additionalProperties: false properties: host: description: The host to get the authentication token for title: host type: string principalId: description: The principal's ID to get the authentication token for format: uuid title: principal_id type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string title: GetHostAuthenticationTokenValueRequest type: object gitpod.v1.ListRunnerEnvironmentSnapshotsRequest: additionalProperties: false properties: filter: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentSnapshotsRequest.Filter' description: filter contains the filter options for listing snapshots title: filter pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing snapshots title: pagination runnerId: description: The runner's identifier format: uuid title: runner_id type: string title: ListRunnerEnvironmentSnapshotsRequest type: object gitpod.v1.UserInputBlock: additionalProperties: false oneOf: - not: anyOf: - required: - text required: - image - not: anyOf: - required: - image required: - text properties: createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: Timestamp when this block was created. Used for debugging and support bundles. title: created_at id: title: id type: string image: $ref: '#/components/schemas/gitpod.v1.UserInputBlock.ImageInput' deprecated: true title: image inputs: items: $ref: '#/components/schemas/gitpod.v1.UserInputBlock.Input' maxItems: 10 title: inputs type: array text: $ref: '#/components/schemas/gitpod.v1.UserInputBlock.TextInput' deprecated: true title: text title: UserInputBlock type: object gitpod.v1.ContextURLInitializer: additionalProperties: false properties: url: description: url is the URL from which the environment is created format: uri title: url type: string title: ContextURLInitializer type: object gitpod.v1.GetManagedRunnerResponse: additionalProperties: false properties: runner: $ref: '#/components/schemas/gitpod.v1.ManagedRunner' title: runner title: GetManagedRunnerResponse type: object gitpod.v1.SCMIntegrationOAuthConfig: additionalProperties: false properties: clientId: description: client_id is the OAuth app's client ID in clear text. title: client_id type: string encryptedClientSecret: description: encrypted_client_secret is the OAuth app's secret encrypted with the runner's public key. format: byte title: encrypted_client_secret type: string issuerUrl: description: "issuer_url is used to override the authentication provider URL, if it doesn't match the SCM host.\n\n +optional if not set, this account is owned by the installation." title: issuer_url type: string title: SCMIntegrationOAuthConfig type: object gitpod.v1.UpdateRunnerEnvironmentStatusResponse: additionalProperties: false title: UpdateRunnerEnvironmentStatusResponse type: object gitpod.v1.GetRunnerEnvironmentRequest: additionalProperties: false properties: environmentId: description: The environment's ID format: uuid title: environment_id type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string title: GetRunnerEnvironmentRequest type: object gitpod.v1.CallCheckRepositoryAccess.Request: additionalProperties: false properties: principalId: description: principal_id is the ID of the user or service account to check access for. title: principal_id type: string repositoryUrl: description: repository_url is the URL of the repository to check access for. title: repository_url type: string title: Request type: object gitpod.v1.CallImprovePromptForAgent.Request: additionalProperties: false properties: agentId: title: agent_id type: string prompt: title: prompt type: string title: Request type: object gitpod.v1.UpdateRunnerConfigurationSchemaResponse: additionalProperties: false title: UpdateRunnerConfigurationSchemaResponse type: object gitpod.v1.WatchRequestsRequest: additionalProperties: false properties: runnerId: description: The runner's identity format: uuid title: runner_id type: string title: WatchRequestsRequest type: object gitpod.v1.EnvironmentStatus.DevContainer.Presence: enum: - PRESENCE_UNSPECIFIED - PRESENCE_GENERATED - PRESENCE_DISCOVERED - PRESENCE_SPECIFIED title: Presence type: string gitpod.v1.KernelControlsAction: description: KernelControlsAction defines how a kernel-level policy violation is handled. enum: - KERNEL_CONTROLS_ACTION_UNSPECIFIED - KERNEL_CONTROLS_ACTION_BLOCK - KERNEL_CONTROLS_ACTION_AUDIT title: KernelControlsAction type: string gitpod.v1.WakeEvent.LoopRetrigger.UnmetCondition: additionalProperties: false properties: description: title: description type: string expression: title: expression type: string id: title: id type: string iteration: format: int32 title: iteration type: integer maxIterations: format: int32 title: max_iterations type: integer reason: title: reason type: string title: UnmetCondition type: object gitpod.v1.WarmPoolPhase: description: WarmPoolPhase represents the lifecycle phase of a warm pool enum: - WARM_POOL_PHASE_UNSPECIFIED - WARM_POOL_PHASE_PENDING - WARM_POOL_PHASE_READY - WARM_POOL_PHASE_DEGRADED - WARM_POOL_PHASE_DELETING - WARM_POOL_PHASE_DELETED title: WarmPoolPhase type: string gitpod.v1.CheckAuthenticationForHostResponse.AuthenticationMethodOAuth2: additionalProperties: false properties: authUrl: description: auth_url is the URL where users can authenticate title: auth_url type: string docsUrl: description: docs_url is the URL to the documentation explaining this authentication method title: docs_url type: string title: AuthenticationMethodOAuth2 type: object gitpod.v1.SearchMode: enum: - SEARCH_MODE_UNSPECIFIED - SEARCH_MODE_KEYWORD - SEARCH_MODE_NATIVE title: SearchMode type: string gitpod.v1.EnvironmentStatus.Machine: additionalProperties: false properties: dualDisk: description: "dual_disk indicates the environment is running with a dual-disk layout\n (separate system and data disks). Set by the runner based on actual\n machine configuration." title: dual_disk type: boolean x-stainless-skip: true failureMessage: description: failure_message contains the reason the machine failed to operate. title: failure_message type: string phase: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.Machine.Phase' description: phase is the current phase of the environment machine title: phase session: description: session is the session that is currently active in the machine. title: session type: string timeout: description: "timeout contains the reason the environment has timed out. If this field is\n empty, the environment has not timed out." title: timeout type: string versions: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.Machine.Versions' description: versions contains the versions of components in the machine. title: versions warningMessage: description: warning_message contains warnings, e.g. when the machine is present but not in the expected state. title: warning_message type: string title: Machine type: object gitpod.v1.AgentMessage: additionalProperties: false description: "AgentMessage is a message sent between agents (e.g. from a parent agent to a\n child agent execution, or vice versa)." properties: payload: description: Free-form payload of the message. title: payload type: string role: $ref: '#/components/schemas/gitpod.v1.AgentMessage.Role' description: The role of the sender in the agent hierarchy. title: role x-stainless-skip: true senderExecutionId: description: The execution ID of the agent that sent this message. title: sender_execution_id type: string x-stainless-skip: true type: $ref: '#/components/schemas/gitpod.v1.AgentMessage.Type' title: type title: AgentMessage type: object gitpod.v1.AgentMessage.Type: enum: - TYPE_UNSPECIFIED - TYPE_UPDATE - TYPE_COMPLETE title: Type type: string gitpod.v1.CallListSCMOrganizations.Request: additionalProperties: false properties: principalId: description: The principal's ID to list organizations for title: principal_id type: string scmHost: description: The SCM host to list organizations from (e.g., "github.com", "gitlab.com") title: scm_host type: string title: Request type: object gitpod.v1.IntegrationLoginCapability: additionalProperties: false description: IntegrationLoginCapability defines login/authentication capability Additional login configuration can be added here title: IntegrationLoginCapability type: object gitpod.v1.FieldValidationError: additionalProperties: false properties: error: title: error type: string key: title: key type: string title: FieldValidationError type: object gitpod.v1.EnvironmentStatus.EnvironmentSSHURL: additionalProperties: false properties: url: title: url type: string title: EnvironmentSSHURL type: object gitpod.v1.EventHostAuthenticationTokenDeleted: additionalProperties: false properties: host: description: The host authentication token's host. title: host type: string principalId: description: The principal ID of the deleted token. format: uuid title: principal_id type: string title: EventHostAuthenticationTokenDeleted type: object gitpod.v1.SearchRepositoriesResponse.Repository: additionalProperties: false properties: name: description: Repository name (e.g., "my-project") title: name type: string url: description: Repository URL (e.g., "https://github.com/owner/my-project") title: url type: string title: Repository type: object gitpod.v1.ListRunnerEnvironmentSnapshotsResponse: additionalProperties: false properties: pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination response title: pagination snapshots: description: snapshots are the snapshots that matched the query items: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshot' title: snapshots type: array title: ListRunnerEnvironmentSnapshotsResponse type: object gitpod.v1.WarmPoolSpec: additionalProperties: false description: WarmPoolSpec contains the desired configuration for a warm pool properties: desiredPhase: $ref: '#/components/schemas/gitpod.v1.WarmPoolPhase' description: "desired_phase is the intended lifecycle phase for this warm pool.\n Managed by the API and reconciler." title: desired_phase desiredSize: deprecated: true description: "desired_size is the number of warm instances to maintain.\n Deprecated: Use min_size and max_size instead for dynamic scaling.\n Existing pools will be migrated to min_size=max_size=desired_size." format: int32 maximum: 20 minimum: 1 title: desired_size type: integer maxSize: description: "max_size is the maximum number of warm instances to maintain.\n The pool will never scale above this value.\n Must be >= min_size and <= 20." format: int32 maximum: 20 minimum: 1 nullable: true title: max_size type: integer minSize: description: "min_size is the minimum number of warm instances to maintain.\n The pool will never scale below this value.\n Must be >= 0 and <= max_size. Set to 0 to allow full scale-down." format: int32 maximum: 20 nullable: true title: min_size type: integer snapshotId: description: "snapshot_id is the prebuild snapshot to warm up in the pool.\n Updated by the reconciler when a new prebuild completes for this\n project and environment class. Empty when no completed prebuild exists yet." format: uuid nullable: true title: snapshot_id type: string specVersion: description: "spec_version is incremented each time the spec is updated.\n Used for optimistic concurrency control." title: spec_version type: string title: WarmPoolSpec type: object gitpod.v1.Gateway: additionalProperties: false description: Gateway represents a system gateway that provides access to services properties: name: description: name is the human-readable name of the gateway. name is unique across all gateways. title: name type: string region: description: region is the geographical region where the gateway is located title: region type: string url: description: url of the gateway title: url type: string required: - name - url title: Gateway type: object gitpod.v1.EnvironmentStatus.RunnerACK.StatusCode: enum: - STATUS_CODE_UNSPECIFIED - STATUS_CODE_OK - STATUS_CODE_INVALID_RESOURCE - STATUS_CODE_FAILED_PRECONDITION title: StatusCode type: string gitpod.v1.GetLatestVersionResponse: additionalProperties: false oneOf: - not: anyOf: - required: - gcp - required: - linuxHost required: - awsEc2 - not: anyOf: - required: - awsEc2 - required: - linuxHost required: - gcp - not: anyOf: - required: - awsEc2 - required: - gcp required: - linuxHost properties: autoUpdate: description: auto-update indicates if the runner should be updated automatically title: auto_update type: boolean awsEc2: $ref: '#/components/schemas/gitpod.v1.GetLatestVersionResponse.AwsEc2Manifest' title: aws_ec2 gcp: $ref: '#/components/schemas/gitpod.v1.GetLatestVersionResponse.GcpManifest' title: gcp gitpodCliDownloadUrl: description: gitpod_cli_download_url is the URL to download the gitpod CLI title: gitpod_cli_download_url type: string hotfix: description: hotfix indicates this release should bypass update windows and be applied immediately. title: hotfix type: boolean linuxHost: $ref: '#/components/schemas/gitpod.v1.GetLatestVersionResponse.LinuxHostManifest' title: linux_host runnerImage: description: 'deprecated: aws-specific field, use manifest.aws_ec2.runner_image instead' title: runner_image type: string supervisorDownloadUrl: description: supervisor_download_url is the URL to download the supervisor title: supervisor_download_url type: string version: description: The latest version of the runner title: version type: string required: - version - autoUpdate title: GetLatestVersionResponse type: object gitpod.v1.RunnerEnvironmentSnapshotSpec: additionalProperties: false description: SnapshotSpec specifies the configuration for creating a snapshot properties: desiredPhase: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshotPhase' description: desired_phase specifies the intended lifecycle phase for this snapshot title: desired_phase providerConfig: additionalProperties: title: value type: string description: provider_config contains provider-specific configuration title: provider_config type: object title: RunnerEnvironmentSnapshotSpec type: object gitpod.v1.UpdateRunnerConfigurationSchemaRequest: additionalProperties: false properties: configSchema: $ref: '#/components/schemas/gitpod.v1.RunnerConfigurationSchema' description: config_schema is the schema for the runner's configuration title: config_schema runnerId: description: The runner's identity format: uuid title: runner_id type: string title: UpdateRunnerConfigurationSchemaRequest type: object gitpod.v1.AgentExecution.WaitingInfo.EnvironmentInterest: additionalProperties: false properties: environmentId: format: uuid title: environment_id type: string phase: description: "Optional. When empty, any terminal phase (running, stopped, deleted)\n fires the interest. Valid values: \"running\", \"stopped\", \"deleted\"." enum: - '' - running - stopped - deleted title: phase type: string title: EnvironmentInterest type: object gitpod.v1.LLMIntegrationRequestHeader: additionalProperties: false description: "LLMIntegrationRequestHeader represents a custom header to be passed to LLM requests.\n The value field contains:\n - Plain text values in update requests (will be encrypted server-side).\n - Encrypted binary values on read requests (decrypt directly to get original value)." properties: key: title: key type: string value: format: byte title: value type: string title: LLMIntegrationRequestHeader type: object gitpod.v1.EnvironmentSpec: additionalProperties: false description: "EnvironmentSpec specifies the configuration of an environment for an environment\n start" properties: admission: $ref: '#/components/schemas/gitpod.v1.AdmissionLevel' description: admission controlls who can access the environment and its ports. title: admission automationsFile: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.AutomationsFile' description: automations_file is the automations file spec of the environment title: automations_file content: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.Content' description: content is the content spec of the environment title: content desiredPhase: $ref: '#/components/schemas/gitpod.v1.EnvironmentPhase' description: Phase is the desired phase of the environment title: desired_phase devcontainer: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.DevContainer' description: devcontainer is the devcontainer spec of the environment title: devcontainer kernelControlsConfig: $ref: '#/components/schemas/gitpod.v1.KernelControlsConfig' description: kernel_controls_config configures kernel-level controls for this environment title: kernel_controls_config machine: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.Machine' description: machine is the machine spec of the environment title: machine ports: description: ports is the set of ports which ought to be exposed to your network items: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.EnvironmentPort' title: ports type: array secrets: description: secrets are confidential data that is mounted into the environment items: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.Secret' title: secrets type: array specVersion: description: "version of the spec. The value of this field has no semantic\n meaning (e.g. don't interpret it as as a timestamp),\n but it can be used to impose a partial order. If a.spec_version <\n b.spec_version then a was the spec before b." title: spec_version type: string sshPublicKeys: description: ssh_public_keys are the public keys used to ssh into the environment items: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.SSHPublicKey' title: ssh_public_keys type: array timeout: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.Timeout' description: Timeout configures the environment timeout title: timeout workflowActionId: description: "workflow_action_id is an optional reference to the workflow execution action\n that created this environment. Used for tracking and event correlation." format: uuid nullable: true title: workflow_action_id type: string title: EnvironmentSpec type: object gitpod.v1.EnvironmentSpec.DevContainer: additionalProperties: false properties: defaultDevcontainerImage: description: default_devcontainer_image is the default image that is used to start the devcontainer if no devcontainer config file is found title: default_devcontainer_image type: string devcontainerFilePath: description: 'devcontainer_file_path is the path to the devcontainer file relative to the repo root path must not be absolute (start with a /): ``` this.matches(''^$|^[^/].*'') ``` ' title: devcontainer_file_path type: string dotfiles: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.DevContainer.Dotfiles' description: 'Experimental: dotfiles is the dotfiles configuration of the devcontainer' title: dotfiles lifecycleStage: $ref: '#/components/schemas/gitpod.v1.EnvironmentSpec.DevContainer.LifecycleStage' description: "lifecycle_stage controls which devcontainer lifecycle commands are executed.\n Defaults to FULL if not specified." title: lifecycle_stage session: title: session type: string title: DevContainer type: object gitpod.v1.EnvironmentStatus.EnvironmentPortURL: additionalProperties: false properties: port: description: port is the port number of the environment port format: int32 maximum: 65535 minimum: 1024 title: port type: integer url: description: url is the URL at which the environment port can be accessed title: url type: string title: EnvironmentPortURL type: object gitpod.v1.AgentExecution.Spec.Limits: additionalProperties: false properties: maxInputTokens: title: max_input_tokens type: string maxIterations: title: max_iterations type: string maxOutputTokens: title: max_output_tokens type: string title: Limits type: object gitpod.v1.GetRunnerLLMIntegrationRequest: additionalProperties: false properties: llmIntegrationId: description: The LLM integration's ID format: uuid title: llm_integration_id type: string runnerId: description: The runner's identity format: uuid title: runner_id type: string title: GetRunnerLLMIntegrationRequest type: object gitpod.v1.ListRunnerIntegrationsRequest: additionalProperties: false properties: filter: $ref: '#/components/schemas/gitpod.v1.ListRunnerIntegrationsRequest.Filter' title: filter pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing integrations title: pagination runnerId: description: The runner's identity format: uuid title: runner_id type: string title: ListRunnerIntegrationsRequest type: object gitpod.v1.UpdateRunnerEnvironmentSnapshotStatusRequest: additionalProperties: false properties: runnerId: description: The runner's identity format: uuid title: runner_id type: string snapshotId: description: snapshot_id specifies the snapshot to delete format: uuid title: snapshot_id type: string status: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironmentSnapshotStatus' description: status is the new status for the snapshot title: status required: - runnerId - snapshotId title: UpdateRunnerEnvironmentSnapshotStatusRequest type: object gitpod.v1.GetRunnerConfigurationResponse: additionalProperties: false properties: configuration: $ref: '#/components/schemas/gitpod.v1.GetRunnerConfigurationResponse.RunnerConfiguration' title: configuration title: GetRunnerConfigurationResponse type: object gitpod.v1.ListManagedRunnersRequest: additionalProperties: false properties: bigPagination: $ref: '#/components/schemas/gitpod.v1.BigPaginationRequest' description: pagination contains the pagination options for listing managed runners (allowing up to 10000 per page) title: big_pagination pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' deprecated: true description: pagination contains the pagination options for listing managed runners title: pagination title: ListManagedRunnersRequest type: object gitpod.v1.AgentExecution.Metadata: additionalProperties: false properties: annotations: additionalProperties: title: value type: string description: annotations are key-value pairs for tracking external context. title: annotations type: object createdAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: created_at creator: $ref: '#/components/schemas/gitpod.v1.Subject' title: creator description: title: description type: string name: title: name type: string role: $ref: '#/components/schemas/gitpod.v1.AgentExecutionRole' description: role is the role of the agent execution title: role sessionId: description: session_id is the ID of the session this agent execution belongs to. title: session_id type: string x-stainless-skip: true updatedAt: $ref: '#/components/schemas/google.protobuf.Timestamp' title: updated_at workflowActionId: description: "workflow_action_id is set when this agent execution was created as part of a workflow.\n Used to correlate agent executions with their parent workflow execution action." format: uuid nullable: true title: workflow_action_id type: string title: Metadata type: object gitpod.v1.SendResponseRequest.ErrorCode: enum: - ERROR_CODE_UNSPECIFIED - ERROR_CODE_CANCELED - ERROR_CODE_INVALID_ARGUMENT - ERROR_CODE_DEADLINE_EXCEEDED - ERROR_CODE_NOT_FOUND - ERROR_CODE_ALREADY_EXISTS - ERROR_CODE_PERMISSION_DENIED - ERROR_CODE_RESOURCE_EXHAUSTED - ERROR_CODE_FAILED_PRECONDITION - ERROR_CODE_UNIMPLEMENTED - ERROR_CODE_UNAVAILABLE - ERROR_CODE_UNAUTHENTICATED title: ErrorCode type: string gitpod.v1.EventEnvironmentSpecChange: additionalProperties: false properties: environmentId: description: The environment's ID format: uuid title: environment_id type: string title: EventEnvironmentSpecChange type: object gitpod.v1.ParseContextURLResponse.GitContext: additionalProperties: false properties: branch: title: branch type: string cloneUrl: title: clone_url type: string commit: title: commit type: string host: title: host type: string owner: title: owner type: string repo: title: repo type: string tag: title: tag type: string upstreamRemoteUrl: title: upstream_remote_url type: string title: GitContext type: object gitpod.v1.EnvironmentInitializer: additionalProperties: false description: EnvironmentInitializer specifies how an environment is to be initialized properties: specs: items: $ref: '#/components/schemas/gitpod.v1.EnvironmentInitializer.Spec' title: specs type: array title: EnvironmentInitializer type: object gitpod.v1.WarmPool: additionalProperties: false description: "WarmPool maintains pre-created environment instances from a prebuild snapshot\n for near-instant environment startup.\n One warm pool exists per pair." properties: id: description: id is the unique identifier for the warm pool format: uuid title: id type: string metadata: $ref: '#/components/schemas/gitpod.v1.WarmPoolMetadata' description: metadata contains organizational and ownership information title: metadata spec: $ref: '#/components/schemas/gitpod.v1.WarmPoolSpec' description: spec contains the desired configuration for this warm pool title: spec status: $ref: '#/components/schemas/gitpod.v1.WarmPoolStatus' description: status contains the current status reported by the runner title: status required: - metadata - spec - status title: WarmPool type: object gitpod.v1.AgentExecution.Status.MCPIntegrationStatus: additionalProperties: false description: "MCPIntegrationStatus represents the status of a single MCP integration\n within an agent execution context" properties: failureMessage: description: failure_message contains the reason the MCP integration failed to connect or operate title: failure_message type: string id: description: id is the unique name of the MCP integration title: id type: string name: description: name is the unique name of the MCP integration (e.g., "linear", "notion") title: name type: string phase: $ref: '#/components/schemas/gitpod.v1.MCPIntegrationPhase' description: phase is the current connection/health phase title: phase warningMessage: description: warning_message contains warnings (e.g., rate limiting, degraded performance) title: warning_message type: string title: MCPIntegrationStatus type: object gitpod.v1.EventIntegrationChange: additionalProperties: false properties: integrationId: description: The integration's ID format: uuid title: integration_id type: string title: EventIntegrationChange type: object gitpod.v1.AgentMode: description: AgentMode defines the operational mode of an agent enum: - AGENT_MODE_UNSPECIFIED - AGENT_MODE_EXECUTION - AGENT_MODE_PLANNING - AGENT_MODE_RALPH - AGENT_MODE_SPEC title: AgentMode type: string gitpod.v1.RunnerCapability: enum: - RUNNER_CAPABILITY_UNSPECIFIED - RUNNER_CAPABILITY_FETCH_LOCAL_SCM_INTEGRATIONS - RUNNER_CAPABILITY_SECRET_CONTAINER_REGISTRY - RUNNER_CAPABILITY_AGENT_EXECUTION - RUNNER_CAPABILITY_ALLOW_ENV_TOKEN_POPULATION - RUNNER_CAPABILITY_DEFAULT_DEV_CONTAINER_IMAGE - RUNNER_CAPABILITY_ENVIRONMENT_SNAPSHOT - RUNNER_CAPABILITY_PREBUILDS_BEFORE_SNAPSHOT_TRIGGER - RUNNER_CAPABILITY_LIST_SCM_ORGANIZATIONS - RUNNER_CAPABILITY_CHECK_REPOSITORY_ACCESS - RUNNER_CAPABILITY_RUNNER_SIDE_AGENT - RUNNER_CAPABILITY_WARM_POOL - RUNNER_CAPABILITY_ASG_WARM_POOL title: RunnerCapability type: string gitpod.v1.GetRunnerConfigurationResponse.RunnerConfiguration: additionalProperties: false properties: autoUpdate: title: auto_update type: boolean continuousProfiling: description: continuous_profiling indicates whether continuous profiling is enabled. title: continuous_profiling type: boolean devcontainerImageCacheEnabled: title: devcontainer_image_cache_enabled type: boolean encryptedHoneycombApiKey: description: encrypted_honeycomb_api_key is the Honeycomb API key encrypted with the runner's public key. format: byte title: encrypted_honeycomb_api_key type: string logLevel: $ref: '#/components/schemas/gitpod.v1.LogLevel' title: log_level metrics: $ref: '#/components/schemas/gitpod.v1.RunnerMetricsConfiguration' title: metrics region: title: region type: string releaseChannel: $ref: '#/components/schemas/gitpod.v1.RunnerReleaseChannel' title: release_channel updateWindow: $ref: '#/components/schemas/gitpod.v1.UpdateWindow' description: "update_window defines the daily time window (UTC) during which auto-updates are allowed.\n If not set, updates are allowed at any time." title: update_window title: RunnerConfiguration type: object gitpod.v1.EnvironmentStatus.AutomationsFile.Presence: enum: - PRESENCE_UNSPECIFIED - PRESENCE_ABSENT - PRESENCE_DISCOVERED - PRESENCE_SPECIFIED title: Presence type: string gitpod.v1.CallValidateConfig.Response: additionalProperties: false oneOf: - not: anyOf: - required: - scm required: - environmentClass - not: anyOf: - required: - environmentClass required: - scm properties: environmentClass: $ref: '#/components/schemas/gitpod.v1.EnvironmentClassValidationResult' title: environment_class scm: $ref: '#/components/schemas/gitpod.v1.SCMIntegrationValidationResult' title: scm title: Response type: object gitpod.v1.EnvironmentRole: description: EnvironmentRole represents the role of an environment enum: - ENVIRONMENT_ROLE_UNSPECIFIED - ENVIRONMENT_ROLE_DEFAULT - ENVIRONMENT_ROLE_PREBUILD - ENVIRONMENT_ROLE_WORKFLOW title: EnvironmentRole type: string gitpod.v1.EnvironmentStatus.DevContainer: additionalProperties: false properties: containerId: description: container_id is the ID of the container. title: container_id type: string containerName: description: container_name is the name of the container that is used to connect to the devcontainer title: container_name type: string devcontainerFilePath: description: devcontainer_file_path is the path to the devcontainer file relative to the repo root title: devcontainer_file_path type: string devcontainerFilePresence: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.DevContainer.Presence' description: devcontainer_file_presence indicates how the devcontainer file is present in the repo. title: devcontainer_file_presence devcontainerconfigInSync: description: devcontainerconfig_in_sync indicates if the devcontainer is up to date w.r.t. the devcontainer config file. title: devcontainerconfig_in_sync type: boolean failureMessage: description: failure_message contains the reason the devcontainer failed to operate. title: failure_message type: string phase: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.DevContainer.Phase' description: phase is the current phase of the devcontainer title: phase remoteUser: description: remote_user is the user that is used to connect to the devcontainer title: remote_user type: string remoteWorkspaceFolder: description: remote_workspace_folder is the folder that is used to connect to the devcontainer title: remote_workspace_folder type: string secretsInSync: description: secrets_in_sync indicates if the secrets are up to date w.r.t. the running devcontainer. title: secrets_in_sync type: boolean session: description: session is the session that is currently active in the devcontainer. title: session type: string warningMessage: description: warning_message contains warnings, e.g. when the devcontainer is present but not in the expected state. title: warning_message type: string title: DevContainer type: object gitpod.v1.ParseContextURLResponse.Issue: additionalProperties: false properties: id: description: id is the source system's ID of this issue, e.g. BNFRD-6100 title: id type: string title: title: title type: string title: Issue type: object gitpod.v1.IntegrationOAuthConfig: additionalProperties: false description: IntegrationOAuthConfig defines OAuth-specific configuration properties: authParams: additionalProperties: title: value type: string description: "auth_params are additional query parameters to include in the OAuth\n authorization URL. Use comma-separated values for multi-value params\n (e.g., \"search:read,chat:write\" for Slack's user_scope)." title: auth_params type: object authUrl: description: auth_url is the OAuth authorization endpoint URL title: auth_url type: string clientId: description: client_id is the OAuth client ID (optional if dynamic_registration is enabled) title: client_id type: string clientSecret: description: client_secret is the OAuth client secret (optional for public clients) title: client_secret type: string dynamicRegistration: description: "dynamic_registration enables RFC 7591 OAuth 2.0 Dynamic Client Registration.\n When enabled, client credentials are obtained automatically from the authorization\n server's registration endpoint (discovered via RFC 8414 metadata).\n When disabled (default), client_id and client_secret must be pre-configured." title: dynamic_registration type: boolean redirectUrl: description: redirect_url is the OAuth callback/redirect URL title: redirect_url type: string scopes: description: scopes are the OAuth scopes to request items: type: string title: scopes type: array tokenUrl: description: token_url is the OAuth token endpoint URL title: token_url type: string title: IntegrationOAuthConfig type: object gitpod.v1.AgentExecution: additionalProperties: false properties: id: description: "ID is a unique identifier of this agent run. No other agent run with the\n same name must be managed by this agent manager" title: id type: string metadata: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Metadata' description: "Metadata is data associated with this agent that's required for other\n parts of Gitpod to function" title: metadata spec: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Spec' description: "Spec is the configuration of the agent that's required for the\n runner to start the agent" title: spec status: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status' description: Status is the current status of the agent title: status title: AgentExecution type: object gitpod.v1.FileChange.ChangeType: description: ChangeType is the type of change that happened to the file enum: - CHANGE_TYPE_UNSPECIFIED - CHANGE_TYPE_ADDED - CHANGE_TYPE_MODIFIED - CHANGE_TYPE_DELETED - CHANGE_TYPE_RENAMED - CHANGE_TYPE_COPIED - CHANGE_TYPE_UPDATED_BUT_UNMERGED - CHANGE_TYPE_UNTRACKED title: ChangeType type: string gitpod.v1.ManagedRunner: additionalProperties: false properties: organizationId: description: The organization's ID that this runner is assigned to format: uuid title: organization_id type: string runnerId: description: The runner's ID format: uuid title: runner_id type: string title: ManagedRunner type: object google.protobuf.Any: additionalProperties: true description: Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. properties: debug: additionalProperties: true type: object type: type: string value: format: binary type: string type: object gitpod.v1.EnvironmentStatus.Secret: additionalProperties: false properties: failureMessage: description: failure_message contains the reason the secret failed to be materialize. title: failure_message type: string id: description: id is the unique identifier of the secret. title: id type: string phase: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.ContentPhase' title: phase secretName: title: secret_name type: string session: description: session is the session that is currently active in the environment. title: session type: string warningMessage: description: warning_message contains warnings, e.g. when the secret is present but not in the expected state. title: warning_message type: string title: Secret type: object gitpod.v1.AgentExecution.WaitingInfo.SubAgentInterest: additionalProperties: false properties: executionId: title: execution_id type: string title: SubAgentInterest type: object gitpod.v1.UpdateRunnerEnvironmentSnapshotStatusResponse: additionalProperties: false title: UpdateRunnerEnvironmentSnapshotStatusResponse type: object gitpod.v1.IntegrationAPIKeyConfig: additionalProperties: false description: IntegrationAPIKeyConfig defines API key authentication configuration Additional API key configuration can be added here title: IntegrationAPIKeyConfig type: object gitpod.v1.EnvironmentPhase: enum: - ENVIRONMENT_PHASE_UNSPECIFIED - ENVIRONMENT_PHASE_CREATING - ENVIRONMENT_PHASE_STARTING - ENVIRONMENT_PHASE_RUNNING - ENVIRONMENT_PHASE_UPDATING - ENVIRONMENT_PHASE_STOPPING - ENVIRONMENT_PHASE_STOPPED - ENVIRONMENT_PHASE_DELETING - ENVIRONMENT_PHASE_DELETED title: EnvironmentPhase type: string gitpod.v1.AgentExecution.Phase: enum: - PHASE_UNSPECIFIED - PHASE_PENDING - PHASE_RUNNING - PHASE_WAITING_FOR_INPUT - PHASE_STOPPED title: Phase type: string gitpod.v1.EnvironmentStatus.Machine.Versions: additionalProperties: false properties: amiId: title: ami_id type: string supervisorCommit: title: supervisor_commit type: string supervisorVersion: title: supervisor_version type: string title: Versions type: object gitpod.v1.UserInputBlock.Input: additionalProperties: false oneOf: - not: anyOf: - required: - text required: - image - not: anyOf: - required: - image required: - text properties: image: $ref: '#/components/schemas/gitpod.v1.UserInputBlock.ImageInput' title: image text: $ref: '#/components/schemas/gitpod.v1.UserInputBlock.TextInput' title: text title: Input type: object gitpod.v1.GitInitializer: additionalProperties: false properties: checkoutLocation: description: "a path relative to the environment root in which the code will be checked out\n to" title: checkout_location type: string cloneTarget: description: the value for the clone target mode - use depends on the target mode title: clone_target type: string remoteUri: description: remote_uri is the Git remote origin title: remote_uri type: string targetMode: $ref: '#/components/schemas/gitpod.v1.GitInitializer.CloneTargetMode' description: the target mode determines what gets checked out title: target_mode upstreamRemoteUri: description: upstream_Remote_uri is the fork upstream of a repository title: upstream_remote_uri type: string title: GitInitializer type: object gitpod.v1.AgentExecution.Spec: additionalProperties: false properties: agentId: format: uuid title: agent_id type: string codeContext: $ref: '#/components/schemas/gitpod.v1.AgentCodeContext' title: code_context desiredPhase: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Phase' description: desired_phase is the desired phase of the agent run title: desired_phase limits: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Spec.Limits' title: limits loopConditions: items: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Spec.LoopCondition' maxItems: 10 title: loop_conditions type: array session: title: session type: string specVersion: description: "version of the spec. The value of this field has no semantic\n meaning (e.g. don't interpret it as as a timestamp),\n but it can be used to impose a partial order. If a.spec_version <\n b.spec_version then a was the spec before b." title: spec_version type: string title: Spec type: object gitpod.v1.GetLatestVersionResponse.AwsEc2Manifest: additionalProperties: false properties: amiImageMap: additionalProperties: title: value type: string deprecated: true description: 'Deprecated: AMI image maps are no longer sent to runners.' title: ami_image_map type: object proxyImage: description: "The container image of the proxy.\n Will only be set if the latest release in the release channel has the same infrastructure version as the runner." title: proxy_image type: string runnerImage: description: "The container image of the runner.\n Will only be set if the latest release in the release channel has the same infrastructure version as the runner." title: runner_image type: string title: AwsEc2Manifest type: object gitpod.v1.PaginationRequest: additionalProperties: false properties: pageSize: description: "Page size is the maximum number of results to retrieve per page.\n Defaults to 25. Maximum 100." format: int32 maximum: 100 title: page_size type: integer token: description: "Token for the next set of results that was returned as next_token of a\n PaginationResponse" title: token type: string title: PaginationRequest type: object gitpod.v1.ListRunnerEnvironmentClassesRequest: additionalProperties: false properties: filter: $ref: '#/components/schemas/gitpod.v1.ListRunnerEnvironmentClassesRequest.Filter' title: filter pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing environment classes title: pagination runnerId: description: The runner's identity format: uuid title: runner_id type: string title: ListRunnerEnvironmentClassesRequest type: object gitpod.v1.GetRunnerWarmPoolResponse: additionalProperties: false properties: warmPool: $ref: '#/components/schemas/gitpod.v1.WarmPool' title: warm_pool required: - warmPool title: GetRunnerWarmPoolResponse type: object gitpod.v1.UserInputBlock.ImageInput: additionalProperties: false description: "ImageInput allows sending images to the agent.\n Client must provide the MIME type; backend validates against magic bytes." properties: data: description: 'Raw image data (max 4MB). Supported formats: PNG, JPEG.' format: byte maxLength: 4194304 minLength: 1 title: data type: string dataRef: description: "Content-addressed reference to offloaded image data.\n Set by the runner when storing in the conversation store; data is cleared.\n Clients never send this field." title: data_ref type: string x-stainless-skip: true mimeType: enum: - image/png - image/jpeg title: mime_type type: string title: ImageInput type: object gitpod.v1.EnvironmentClassValidationResult: additionalProperties: false properties: configurationErrors: items: $ref: '#/components/schemas/gitpod.v1.FieldValidationError' title: configuration_errors type: array descriptionError: nullable: true title: description_error type: string displayNameError: nullable: true title: display_name_error type: string valid: title: valid type: boolean title: EnvironmentClassValidationResult type: object gitpod.v1.LLMUsage: additionalProperties: false properties: cacheInputCreationTokens: description: Number of tokens used for cache input creation title: cache_input_creation_tokens type: string cachedInputTokens: description: Number of cached input tokens used title: cached_input_tokens type: string ephemeral1hInputTokens: description: Number of ephemeral 1-hour input tokens used title: ephemeral_1h_input_tokens type: string ephemeral5mInputTokens: description: Number of ephemeral 5-minute input tokens used title: ephemeral_5m_input_tokens type: string inputTokens: description: Number of input tokens consumed title: input_tokens type: string outputTokens: description: Number of output tokens generated title: output_tokens type: string title: LLMUsage type: object gitpod.v1.AgentExecutionRole: description: AgentExecutionRole represents the role of an agent execution enum: - AGENT_EXECUTION_ROLE_UNSPECIFIED - AGENT_EXECUTION_ROLE_DEFAULT - AGENT_EXECUTION_ROLE_WORKFLOW title: AgentExecutionRole type: string gitpod.v1.EnvironmentClass: additionalProperties: false properties: configuration: description: configuration describes the configuration of the environment class items: $ref: '#/components/schemas/gitpod.v1.FieldValue' title: configuration type: array description: description: description is a human readable description of the environment class maxLength: 200 minLength: 3 title: description type: string displayName: description: display_name is the human readable name of the environment class maxLength: 127 minLength: 3 title: display_name type: string enabled: description: "enabled indicates whether the environment class can be used to create\n new environments." title: enabled type: boolean id: description: id is the unique identifier of the environment class title: id type: string runnerId: description: runner_id is the unique identifier of the runner the environment class belongs to title: runner_id type: string required: - id - runnerId title: EnvironmentClass type: object gitpod.v1.LogLevel: enum: - LOG_LEVEL_UNSPECIFIED - LOG_LEVEL_DEBUG - LOG_LEVEL_INFO - LOG_LEVEL_WARN - LOG_LEVEL_ERROR title: LogLevel type: string gitpod.v1.EnvironmentSpec.Secret.Scope: description: Scope indicates the origin of the secret for filtering purposes. enum: - SCOPE_UNSPECIFIED - SCOPE_ORGANIZATION - SCOPE_PROJECT - SCOPE_USER - SCOPE_SERVICE_ACCOUNT - SCOPE_RUNNER title: Scope type: string gitpod.v1.SCMIntegration: additionalProperties: false properties: host: title: host type: string id: description: id is the unique identifier of the SCM integration title: id type: string oauth: $ref: '#/components/schemas/gitpod.v1.SCMIntegrationOAuthConfig' nullable: true title: oauth pat: title: pat type: boolean runnerId: title: runner_id type: string scmId: description: scm_id references the scm_id in the runner's configuration schema that this integration is for title: scm_id type: string virtualDirectory: description: "virtual_directory is the virtual directory path for Azure DevOps Server (e.g., \"/tfs\").\n This field is only used for Azure DevOps Server SCM integrations and should be empty for other SCM types.\n Azure DevOps Server APIs work without collection when PAT scope is 'All accessible organizations'." nullable: true title: virtual_directory type: string title: SCMIntegration type: object gitpod.v1.SCMContext: additionalProperties: false properties: email: title: email type: string host: title: host type: string remoteUri: title: remote_uri type: string token: title: token type: string username: title: username type: string title: SCMContext type: object gitpod.v1.EventAgentExecutionSpecChange: additionalProperties: false properties: agentExecutionId: description: The agent execution's ID format: uuid title: agent_execution_id type: string title: EventAgentExecutionSpecChange type: object gitpod.v1.EnvironmentStatus: additionalProperties: false description: EnvironmentStatus describes an environment status properties: activitySignal: $ref: '#/components/schemas/gitpod.v1.EnvironmentActivitySignal' description: activity_signal is the last activity signal for the environment. title: activity_signal automationsFile: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.AutomationsFile' description: automations_file contains the status of the automations file. title: automations_file content: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.Content' description: content contains the status of the environment content. title: content devcontainer: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.DevContainer' description: devcontainer contains the status of the devcontainer. title: devcontainer environmentUrls: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.EnvironmentURLs' description: "environment_url contains the URL at which the environment can be accessed.\n This field is only set if the environment is running." title: environment_urls failureMessage: description: "failure_message summarises why the environment failed to operate. If this is non-empty\n the environment has failed to operate and will likely transition to a stopped state." items: type: string title: failure_message type: array machine: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.Machine' description: machine contains the status of the environment machine title: machine phase: $ref: '#/components/schemas/gitpod.v1.EnvironmentPhase' description: "the phase of an environment is a simple, high-level summary of where the\n environment is in its lifecycle" title: phase runnerAck: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.RunnerACK' description: "runner_ack contains the acknowledgement from the runner that is has\n received the environment spec." title: runner_ack secrets: description: secrets contains the status of the environment secrets items: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.Secret' title: secrets type: array sshPublicKeys: description: ssh_public_keys contains the status of the environment ssh public keys items: $ref: '#/components/schemas/gitpod.v1.EnvironmentStatus.SSHPublicKey' title: ssh_public_keys type: array statusVersion: description: "version of the status update. Environment instances themselves are\n unversioned, but their status has different versions. The value of this\n field has no semantic meaning (e.g. don't interpret it as as a timestamp),\n but it can be used to impose a partial order. If a.status_version <\n b.status_version then a was the status before b." title: status_version type: string warningMessage: description: warning_message contains warnings, e.g. when the environment is present but not in the expected state. items: type: string title: warning_message type: array title: EnvironmentStatus type: object gitpod.v1.CallParseContext.Response: additionalProperties: false properties: resp: $ref: '#/components/schemas/gitpod.v1.ParseContextURLResponse' title: resp title: Response type: object gitpod.v1.PaginationResponse: additionalProperties: false properties: nextToken: description: "Token passed for retrieving the next set of results. Empty if there are no\n more results" title: next_token type: string title: PaginationResponse type: object gitpod.v1.PullRequest: additionalProperties: false description: "PullRequest represents pull request metadata from source control systems.\n This message is used across workflow triggers, executions, and agent contexts\n to maintain consistent PR information throughout the system." properties: author: description: Author name as provided by the SCM system title: author type: string draft: description: Whether this is a draft pull request title: draft type: boolean fromBranch: description: Source branch name (the branch being merged from) title: from_branch type: string id: description: 'Unique identifier from the source system (e.g., "123" for GitHub PR #123)' title: id type: string repository: $ref: '#/components/schemas/gitpod.v1.PullRequest.Repository' title: repository state: $ref: '#/components/schemas/gitpod.v1.PullRequest.State' title: state title: description: Pull request title title: title type: string toBranch: description: Target branch name (the branch being merged into) title: to_branch type: string url: description: Pull request URL (e.g., "https://github.com/owner/repo/pull/123") title: url type: string title: PullRequest type: object gitpod.v1.GetRunnerEnvironmentResponse: additionalProperties: false properties: environment: $ref: '#/components/schemas/gitpod.v1.RunnerEnvironment' title: environment title: GetRunnerEnvironmentResponse type: object google.protobuf.Timestamp: description: "A Timestamp represents a point in time independent of any time zone or local\n calendar, encoded as a count of seconds and fractions of seconds at\n nanosecond resolution. The count is relative to an epoch at UTC midnight on\n January 1, 1970, in the proleptic Gregorian calendar which extends the\n Gregorian calendar backwards to year one.\n\n All minutes are 60 seconds long. Leap seconds are \"smeared\" so that no leap\n second table is needed for interpretation, using a [24-hour linear\n smear](https://developers.google.com/time/smear).\n\n The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By\n restricting to that range, we ensure that we can convert to and from [RFC\n 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.\n\n # Examples\n\n Example 1: Compute Timestamp from POSIX `time()`.\n\n Timestamp timestamp;\n timestamp.set_seconds(time(NULL));\n timestamp.set_nanos(0);\n\n Example 2: Compute Timestamp from POSIX `gettimeofday()`.\n\n struct timeval tv;\n gettimeofday(&tv, NULL);\n\n Timestamp timestamp;\n timestamp.set_seconds(tv.tv_sec);\n timestamp.set_nanos(tv.tv_usec * 1000);\n\n Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.\n\n FILETIME ft;\n GetSystemTimeAsFileTime(&ft);\n UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;\n\n // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z\n // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.\n Timestamp timestamp;\n timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));\n timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));\n\n Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.\n\n long millis = System.currentTimeMillis();\n\n Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)\n .setNanos((int) ((millis % 1000) * 1000000)).build();\n\n Example 5: Compute Timestamp from Java `Instant.now()`.\n\n Instant now = Instant.now();\n\n Timestamp timestamp =\n Timestamp.newBuilder().setSeconds(now.getEpochSecond())\n .setNanos(now.getNano()).build();\n\n Example 6: Compute Timestamp from current time in Python.\n\n timestamp = Timestamp()\n timestamp.GetCurrentTime()\n\n # JSON Mapping\n\n In JSON format, the Timestamp type is encoded as a string in the\n [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the\n format is \"{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z\"\n where {year} is always expressed using four digits while {month}, {day},\n {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional\n seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),\n are optional. The \"Z\" suffix indicates the timezone (\"UTC\"); the timezone\n is required. A proto3 JSON serializer should always use UTC (as indicated by\n \"Z\") when printing the Timestamp type and a proto3 JSON parser should be\n able to accept both UTC and other timezones (as indicated by an offset).\n\n For example, \"2017-01-15T01:30:15.01Z\" encodes 15.01 seconds past\n 01:30 UTC on January 15, 2017.\n\n In JavaScript, one can convert a Date object to this format using the\n standard\n [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)\n method. In Python, a standard `datetime.datetime` object can be converted\n to this format using\n [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with\n the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use\n the Joda Time's [`ISODateTimeFormat.dateTime()`](\n http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()\n ) to obtain a formatter capable of generating timestamps in this format." format: date-time type: string gitpod.v1.GetHostAuthenticationTokenValueResponse: additionalProperties: false properties: expiresAt: $ref: '#/components/schemas/google.protobuf.Timestamp' description: The host authentication token's expiry title: expires_at refreshToken: description: The host authentication token's refresh token encrypted as NaCL anonymous sealed box using the runner's public key format: byte title: refresh_token type: string source: $ref: '#/components/schemas/gitpod.v1.HostAuthenticationTokenSource' description: The host authentication token's source title: source tokenId: description: The host authentication token's ID title: token_id type: string value: description: The authentication token encrypted as NaCL anonymous sealed box using the runner's public key format: byte title: value type: string title: GetHostAuthenticationTokenValueResponse type: object gitpod.v1.ListRunnerIntegrationsRequest.Filter: additionalProperties: false properties: integrationIds: description: integration_ids filters the response to only integrations with these IDs items: format: uuid maxItems: 25 type: string maxItems: 25 title: integration_ids type: array title: Filter type: object gitpod.v1.WatchRequestsResponse: additionalProperties: false oneOf: - not: anyOf: - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callCheckAuthenticationForHost - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callCheckRepositoryAccess - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callImprovePromptForAgent - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callListScmOrganizations - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callParseContext - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callPing - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callSearchRepositories - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callSendMessageToAgentExecution - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - callValidateConfig - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventAgentExecutionSpecChange - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventEnvironmentMarkedActive - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventEnvironmentSpecChange - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventHostAuthenticationTokenDeleted - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventIntegrationChange - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventLlmIntegrationChange - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventRunnerConfigurationChange - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventSnapshotSpecChange - required: - eventWarmPoolSpecChange required: - eventScmIntegrationChange - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventWarmPoolSpecChange required: - eventSnapshotSpecChange - not: anyOf: - required: - callCheckAuthenticationForHost - required: - callCheckRepositoryAccess - required: - callImprovePromptForAgent - required: - callListScmOrganizations - required: - callParseContext - required: - callPing - required: - callSearchRepositories - required: - callSendMessageToAgentExecution - required: - callValidateConfig - required: - eventAgentExecutionSpecChange - required: - eventEnvironmentMarkedActive - required: - eventEnvironmentSpecChange - required: - eventHostAuthenticationTokenDeleted - required: - eventIntegrationChange - required: - eventLlmIntegrationChange - required: - eventRunnerConfigurationChange - required: - eventScmIntegrationChange - required: - eventSnapshotSpecChange required: - eventWarmPoolSpecChange properties: callCheckAuthenticationForHost: $ref: '#/components/schemas/gitpod.v1.CallCheckAuthenticationForHost.Request' title: call_check_authentication_for_host callCheckRepositoryAccess: $ref: '#/components/schemas/gitpod.v1.CallCheckRepositoryAccess.Request' title: call_check_repository_access callImprovePromptForAgent: $ref: '#/components/schemas/gitpod.v1.CallImprovePromptForAgent.Request' title: call_improve_prompt_for_agent callListScmOrganizations: $ref: '#/components/schemas/gitpod.v1.CallListSCMOrganizations.Request' title: call_list_scm_organizations callParseContext: $ref: '#/components/schemas/gitpod.v1.CallParseContext.Request' title: call_parse_context callPing: $ref: '#/components/schemas/gitpod.v1.CallPing.Request' title: call_ping callSearchRepositories: $ref: '#/components/schemas/gitpod.v1.CallSearchRepositories.Request' title: call_search_repositories callSendMessageToAgentExecution: $ref: '#/components/schemas/gitpod.v1.CallSendMessageToAgentExecution.Request' title: call_send_message_to_agent_execution callValidateConfig: $ref: '#/components/schemas/gitpod.v1.CallValidateConfig.Request' title: call_validate_config eventAgentExecutionSpecChange: $ref: '#/components/schemas/gitpod.v1.EventAgentExecutionSpecChange' title: event_agent_execution_spec_change eventEnvironmentMarkedActive: $ref: '#/components/schemas/gitpod.v1.EventEnvironmentMarkedActive' title: event_environment_marked_active eventEnvironmentSpecChange: $ref: '#/components/schemas/gitpod.v1.EventEnvironmentSpecChange' title: event_environment_spec_change eventHostAuthenticationTokenDeleted: $ref: '#/components/schemas/gitpod.v1.EventHostAuthenticationTokenDeleted' title: event_host_authentication_token_deleted eventIntegrationChange: $ref: '#/components/schemas/gitpod.v1.EventIntegrationChange' title: event_integration_change eventLlmIntegrationChange: $ref: '#/components/schemas/gitpod.v1.EventLLMIntegrationChange' title: event_llm_integration_change eventRunnerConfigurationChange: $ref: '#/components/schemas/gitpod.v1.EventRunnerConfigurationChange' title: event_runner_configuration_change eventScmIntegrationChange: $ref: '#/components/schemas/gitpod.v1.EventSCMIntegrationChange' title: event_scm_integration_change eventSnapshotSpecChange: $ref: '#/components/schemas/gitpod.v1.EventSnapshotSpecChange' title: event_snapshot_spec_change eventWarmPoolSpecChange: $ref: '#/components/schemas/gitpod.v1.EventWarmPoolSpecChange' title: event_warm_pool_spec_change requestId: description: The request's ID format: uuid title: request_id type: string title: WatchRequestsResponse type: object gitpod.v1.ListRunnerAgentExecutionsRequest.Filter: additionalProperties: false properties: activeOnly: description: "When true, only return agent executions that require processing.\n Excludes executions where phase is terminal (stopped/waiting_for_input)\n and spec.session matches status.session (no new user input)." title: active_only type: boolean agentExecutionIds: description: When set, only return agent executions matching these IDs. items: format: uuid maxItems: 500 type: string maxItems: 500 title: agent_execution_ids type: array idsOnly: description: "When true, return only execution IDs without full content\n (no spec, status, metadata, or access token)." title: ids_only type: boolean title: Filter type: object gitpod.v1.BPFDebugLevel: description: "BPFDebugLevel controls the verbosity of BPF trace_pipe output (bpf_printk).\n Applies to all BPF-based agents (veto exec, future agents)." enum: - BPF_DEBUG_LEVEL_UNSPECIFIED - BPF_DEBUG_LEVEL_INFO - BPF_DEBUG_LEVEL_VERBOSE title: BPFDebugLevel type: string gitpod.v1.ListRunnerSCMIntegrationsRequest: additionalProperties: false properties: filter: $ref: '#/components/schemas/gitpod.v1.ListRunnerSCMIntegrationsRequest.Filter' title: filter pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing SCM integrations title: pagination runnerId: description: The runner's identity format: uuid title: runner_id type: string title: ListRunnerSCMIntegrationsRequest type: object gitpod.v1.EventEnvironmentMarkedActive: additionalProperties: false properties: environmentId: description: The environment's ID format: uuid title: environment_id type: string title: EventEnvironmentMarkedActive type: object gitpod.v1.EnvironmentStatus.ContentPhase: enum: - CONTENT_PHASE_UNSPECIFIED - CONTENT_PHASE_CREATING - CONTENT_PHASE_INITIALIZING - CONTENT_PHASE_READY - CONTENT_PHASE_UPDATING - CONTENT_PHASE_FAILED - CONTENT_PHASE_UNAVAILABLE title: ContentPhase type: string gitpod.v1.ListSCMOrganizationsResponse.SCMOrganization: additionalProperties: false properties: isAdmin: description: "Whether the user has admin permissions in this organization.\n Admin permissions typically allow creating organization-level webhooks." title: is_admin type: boolean name: description: Organization name/slug (e.g., "gitpod-io") title: name type: string url: description: Organization URL (e.g., "https://github.com/gitpod-io") title: url type: string title: SCMOrganization type: object gitpod.v1.FieldValueUpdate: additionalProperties: false properties: key: description: key is the field key to update. If the field does not exist, it will be created. title: key type: string value: description: value is the new value for the field. If value is empty, the field will be removed. nullable: true title: value type: string title: FieldValueUpdate type: object gitpod.v1.ListRunnerSCMIntegrationsResponse: additionalProperties: false properties: pagination: $ref: '#/components/schemas/gitpod.v1.PaginationResponse' description: pagination contains the pagination options for listing SCM integrations title: pagination scmIntegrations: description: The SCM integrations configured for the runner items: $ref: '#/components/schemas/gitpod.v1.SCMIntegration' title: scm_integrations type: array title: ListRunnerSCMIntegrationsResponse type: object gitpod.v1.ListRunnerEnvironmentSnapshotsRequest.Filter: additionalProperties: false properties: snapshotIds: items: format: uuid maxItems: 25 type: string maxItems: 25 title: snapshot_ids type: array title: Filter type: object gitpod.v1.Veto: additionalProperties: false description: Veto controls kernel-level blocking mechanisms properties: exec: $ref: '#/components/schemas/gitpod.v1.Veto.Exec' description: exec controls executable blocking title: exec title: Veto type: object gitpod.v1.ListRunnerEnvironmentsRequest: additionalProperties: false properties: environmentIds: description: "An optional list of environment IDs to fetch. If this list is empty/not provided\n all environments that ought to run on the runner are returned." items: format: uuid type: string title: environment_ids type: array pagination: $ref: '#/components/schemas/gitpod.v1.PaginationRequest' description: pagination contains the pagination options for listing environments title: pagination runnerId: description: The runner's identifier format: uuid title: runner_id type: string title: ListRunnerEnvironmentsRequest type: object gitpod.v1.UpdateWindow: additionalProperties: false description: "UpdateWindow defines a daily time window (UTC) during which auto-updates are allowed.\n The window must be at least 2 hours long.\n Overnight windows are supported (e.g., start_hour=22, end_hour=4)." properties: endHour: description: "end_hour is the end of the update window as a UTC hour (0-23).\n If not set, defaults to start_hour + 2." nullable: true title: end_hour type: integer startHour: description: "start_hour is the beginning of the update window as a UTC hour (0-23).\n +required" nullable: true title: start_hour type: integer title: UpdateWindow type: object gitpod.v1.IntegrationAgentClientCapability: additionalProperties: false description: "IntegrationAgentClientCapability indicates the integration supports agent client functionality.\n The webhook signing secret is stored in IntegrationProprietaryAppConfig.webhook_secret. Empty - presence of this capability indicates agent client support" title: IntegrationAgentClientCapability type: object gitpod.v1.RunnerConfigurationSchema.PersonalAccessToken: additionalProperties: false properties: description: description: description is a human-readable description of the PAT. title: description type: string docsLink: description: docs_link is a link to the documentation on how to create a PAT for this SCM system. title: docs_link type: string title: PersonalAccessToken type: object gitpod.v1.UpdateRunnerAgentExecutionRequest: additionalProperties: false properties: agentExecutionId: format: uuid title: agent_execution_id type: string description: nullable: true title: description type: string name: nullable: true title: name type: string runnerId: format: uuid title: runner_id type: string status: $ref: '#/components/schemas/gitpod.v1.AgentExecution.Status' title: status title: UpdateRunnerAgentExecutionRequest type: object gitpod.v1.SendResponseRequest.CallError: additionalProperties: false properties: code: $ref: '#/components/schemas/gitpod.v1.SendResponseRequest.ErrorCode' description: The error's code title: code details: description: Error details items: $ref: '#/components/schemas/google.protobuf.Any' title: details type: array message: description: The error's message title: message type: string title: CallError type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http x-tagGroups: - name: gitpod.v1 tags: - gitpod.v1.AccountService - gitpod.v1.AgentService - gitpod.v1.AgentSecurityService - gitpod.v1.BillingService - gitpod.v1.EditorService - gitpod.v1.EnvironmentAutomationService - gitpod.v1.EnvironmentService - gitpod.v1.ErrorsService - gitpod.v1.EventService - gitpod.v1.GatewayService - gitpod.v1.GroupService - gitpod.v1.IdentityService - gitpod.v1.InsightsService - gitpod.v1.IntegrationService - gitpod.v1.NotificationService - gitpod.v1.OnaIntelligenceService - gitpod.v1.OrganizationService - gitpod.v1.PrebuildService - gitpod.v1.ProjectService - gitpod.v1.RunnerConfigurationService - gitpod.v1.RunnerInteractionService - gitpod.v1.RunnerManagerService - gitpod.v1.RunnerService - gitpod.v1.SecretService - gitpod.v1.ServiceAccountService - gitpod.v1.SessionService - gitpod.v1.TeamService - gitpod.v1.UsageService - gitpod.v1.UserService - gitpod.v1.WebhookService - gitpod.v1.WorkflowService