v18

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

MarkRunnerActive

Maintains the active status of a runner through periodic heartbeat signals. The runner must call this method every 30 seconds to indicate it's healthy and ready to accept workloads.

Use this method to:

  • Keep runners marked as available in the system
  • Maintain health check status
  • Prevent automatic deregistration
  • Signal readiness for new workloads

Examples

  • Send heartbeat:

    Marks a runner as active and healthy.

    runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
    
post/gitpod.v1.RunnerInteractionService/MarkRunnerActive

Request body

runnerIdstring uuid

The runner's identity

Response

Success

GitpodV1MarkRunnerActiveResponse required