Sign in

Create a run (role elevates per operation; apply/destroy on a workspace that requires approval needs admin)

post/workspaces/{workspaceId}/runs

Request

  • Base URL: /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/workspaces/{workspaceId}/runs
  • Auth: HTTP bearer

Path parameters

workspaceIdstring required

Request body

operation'plan' | 'apply' | 'destroy' | 'import' | 'test'

Response

Created run

idstring required
workspace_idstring required
org_idstring required
operation'plan' | 'apply' | 'destroy' | 'import' | 'test' required
status'pending' | 'queued' | 'planning' | 'planned' | 'awaiting_approval' | 'applying' | 'applied' | 'errored' | 'cancelled' | 'discarded' required
plan_outputstring
plan_log_urlstring
apply_log_urlstring
resources_addedinteger
resources_changedinteger
resources_deletedinteger
error_messagestring
commit_shastring
plan_json_urlstring
created_bystring required
started_atstring date-time nullable
finished_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 14 revisions of this API.