v18

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

CreateAgentExecutionActorToken

Creates a short-lived actor token for a specific agent execution on this runner.

Use this method to:

  • Fetch the actor token on demand without re-listing executions
  • Refresh an actor token when the previous one expires

Examples

  • Create actor token:

    Retrieves a fresh actor token for a runner-owned agent execution.

    runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
    agentExecutionId: "07e03a28-65a5-4d98-b532-8ea67b188048"
    
post/gitpod.v1.RunnerInteractionService/CreateAgentExecutionActorToken

Request body

agentExecutionIdstring uuid
runnerIdstring uuid

Response

Success

actorAccessTokenstring required

actor_access_token is the token that can be used as the agent execution's actor.