Sign in
latestOpenAPI 3.0.32026-08-10152216352.3 KB

eea119b4113f

Self-Hosted Runners

Run a task v2 (self-hosted)

Initiates a new task execution with enhanced response (self-hosted)

post/self-hosted/{accountId}/tasks/run/v2

Path parameters

accountIdstring required

Unique identifier of the account

Request body

accountIdstring

Account ID

type'post-plan' | 'post-apply' required

The type of task in the workflow

flowSubTaskType[] required

Flow of sub-tasks to execute

contentobject required

Map of sub-task types to content (base64-encoded byte arrays)

metadataTaskMetadata

Metadata for the task

runnerTypestring

Type of runner

repostring

Repository name

workspacestring

Workspace name

availableLogsstring[]

List of available log identifiers

tfWorkingDirstring

Terraform working directory

environmentstring

Environment name

Example request

{
  "type": "post-plan"
}

Response

Task initiated successfully

taskIdstring required
shouldWaitboolean required