Sign in
latestOpenAPI 3.0.32026-08-10152216352.3 KB

eea119b4113f

Self-Hosted Runners

Get the last workspace run (self-hosted)

get/self-hosted/{accountId}/workspaces/{workspaceId}/runs/last

Path parameters

accountIdstring required

Unique identifier of the account

workspaceIdstring required

Unique identifier of the workspace

Response

Last workspace run retrieved successfully

idstring

Unique identifier

accountIdstring

Unique identifier of the account

createdAtstring date-time

Timestamp when the entity was created

updatedAtstring date-time

Timestamp when the entity was last updated

workspaceIdstring

Unique identifier of the associated workspace

workspaceNamestring

Name of the workspace

runIdstring

Unique identifier for the run

runNamestring

Name of the run

status'pending' | 'running' | 'success' | 'failed' | 'canceled' | 'initializing' | 'queued' | 'planning' | 'planning_destroy' | 'applying' | 'destroying' | 'ready_for_apply' | 'ready_for_destroy' | 'destroyed' | 'destroy_plan_completed' | 'destroy_plan_failed' | 'destroy_failed' | 'discarded' | 'canceling_init' | 'canceling_plan' | 'canceling_planning_destroy' | 'canceling_apply' | 'canceling_destroy' | 'canceled_init' | 'canceled_plan' | 'canceled_planning_destroy' | 'canceled_apply' | 'canceled_destroy' | 'init_error' | 'plan_success' | 'plan_error' | 'apply_error' | 'apply_success' | 'blocked' | 'Acknowledged' | 'plan_no_changes' | 'apply_no_changes' | 'runner_failure'

The status of a workspace run

pullRequestIdstring

ID of the associated pull request

pullRequestUrlstring

URL of the associated pull request

branchstring

Branch associated with the run

commitIdstring

ID of the commit

commitUrlstring

URL of the commit

runnerType'github-actions' | 'gitlab-pipelines' | 'bitbucket-pipelines' | 'azure-pipelines' | 'jenkins' | 'semaphore' | 'atlantis' | 'env0' | 'firefly' | 'unrecognized'

The type of CI/CD runner or pipeline system

buildIdstring

ID of the build

buildUrlstring

URL of the build

buildNamestring

Name of the build

vcsType'github' | 'gitlab' | 'bitbucket' | 'codecommit' | 'azuredevops'

The type of version control system

repostring

Repository associated with the run

repoUrlstring

URL of the repository

titlestring

Title of the run

terraformVersionstring

Version of Terraform used

iacType'terraform' | 'opentofu' | 'k8s'

Type of Infrastructure as Code

planTaskIdstring

Unique identifier of the plan task

applyTaskIdstring

Unique identifier of the apply task

Example response

{
  "id": "507f1f77bcf86cd799439011",
  "accountId": "507f1f77bcf86cd799439011",
  "workspaceId": "507f1f77bcf86cd799439012",
  "workspaceName": "production-infra",
  "runId": "run-123456",
  "runName": "Deploy to Production",
  "status": "plan_success",
  "pullRequestId": "123",
  "pullRequestUrl": "https://github.com/org/repo/pull/123",
  "branch": "main",
  "commitId": "abc123def456",
  "commitUrl": "https://github.com/org/repo/commit/abc123def456",
  "runnerType": "github-actions",
  "buildId": "build-789012",
  "buildUrl": "https://github.com/org/repo/actions/runs/789012",
  "buildName": "CI Build",
  "vcsType": "github",
  "repo": "org/repo",
  "repoUrl": "https://github.com/org/repo",
  "ownerSummary": {
    "email": "john.doe@example.com",
    "name": "John Doe",
    "initials": "JD",
    "customColor": "#00000F"
  },
  "title": "Update infrastructure for new feature",
  "terraformVersion": "1.0.11",
  "iacType": "terraform",
  "backendSummary": {
    "backendType": "s3"
  },
  "planTaskId": "507f1f77bcf86cd799439013",
  "applyTaskId": "507f1f77bcf86cd799439014",
  "plan": [
    {
      "id": "507f1f77bcf86cd799439011",
      "accountId": "507f1f77bcf86cd799439011",
      "status": "completed",
      "resultStatus": "success",
      "type": "post-plan",
      "guardrailsSummary": {
        "total": 10,
        "passed": 8,
        "failed": 2,
        "violations": [
          {
            "id": "v1",
            "severity": "high",
            "message": "Resource does not have required tags"
          }
        ]
      },
      "backendSummary": {
        "type": "s3",
        "config": {
          "bucket": "terraform-state",
          "key": "prod/terraform.tfstate"
        },
        "resources": 42
      },
      "changedFilesCodeSummary": {
        "total": 5,
        "added": 2,
        "modified": 3,
        "files": [
          {
            "path": "main.tf",
            "type": "modified"
          }
        ]
      },
      "vcsType": "github",
      "runnerType": "github-actions"
    }
  ],
  "apply": [
    {
      "id": "507f1f77bcf86cd799439011",
      "accountId": "507f1f77bcf86cd799439011",
      "status": "completed",
      "resultStatus": "success",
      "type": "post-plan",
      "guardrailsSummary": {
        "total": 10,
        "passed": 8,
        "failed": 2,
        "violations": [
          {
            "id": "v1",
            "severity": "high",
            "message": "Resource does not have required tags"
          }
        ]
      },
      "backendSummary": {
        "type": "s3",
        "config": {
          "bucket": "terraform-state",
          "key": "prod/terraform.tfstate"
        },
        "resources": 42
      },
      "changedFilesCodeSummary": {
        "total": 5,
        "added": 2,
        "modified": 3,
        "files": [
          {
            "path": "main.tf",
            "type": "modified"
          }
        ]
      },
      "vcsType": "github",
      "runnerType": "github-actions"
    }
  ]
}