Search Terraform documentation » Run Tasks APINote: Run Tasks is a paid feature, available as part of the Team & Governance upgrade package. Refer to Terraform Cloud pricing for details.
Run tasks allow Terraform Cloud to interact with external systems at specific points in the Terraform Cloud run lifecycle. Run tasks are reusable configurations that you can attach to any workspace in an organization. This page lists the API endpoints for run tasks in an organization and explains how to attach run tasks to workspaces.
Refer to run tasks Integration for the API endpoints related triggering run tasks and the expected integration response.
» Required PermissionsTo interact with run tasks on an organization, you need the Manage Run Tasks permission . To associate or dissociate run tasks in a workspace, you need the Manage Workspace Run Tasks permission on that particular workspace.
» Create a Run TaskPOST /organizations/:organization_name/tasks
Parameter Description :organization_name
The organization to create a run task in. The organization must already exist in Terraform Cloud, and the token authenticating the API request must have owner permission .
» Request BodyThis POST endpoint requires a JSON object with the following properties as a request payload.
Properties without a default value are required unless otherwise specified.
Key path Type Default Description data.type
string Must be "tasks"
. data.attributes.name
string The name of the task. Can include letters, numbers, -
, and _
. data.attributes.url
string URL to send a run task payload. data.attributes.description
string The description of the run task. Can include spaces, letters, numbers, and special characters data.attributes.category
string Must be "task"
. data.attributes.hmac-key
string (Optional) HMAC key to verify run task. data.attributes.enabled
bool true (Optional) Whether the task will be run.
» Sample Payload{
"data" : {
"type" : "tasks" ,
"attributes" : {
"name" : "example" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"hmac_key" : "secret" ,
"enabled" : "true" ,
"category" : "task"
}
}
}
{
"data" : {
"type" : "tasks" ,
"attributes" : {
"name" : "example" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"hmac_key" : "secret" ,
"enabled" : "true" ,
"category" : "task"
}
}
}
» Sample Requestcurl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request POST \
--data @payload.json \
https://app.terraform.io/api/v2/organizations/my-organization/tasks
curl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request POST \
--data @payload.json \
https://app.terraform.io/api/v2/organizations/my-organization/tasks
» Sample Response{
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "my-run-task" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"enabled" : "true" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [ ]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
}
{
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "my-run-task" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"enabled" : "true" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [ ]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
}
» List Run TasksGET /organizations/:organization_name/tasks
Parameter Description :organization_name
The organization to list tasks for.
» Query ParametersThis endpoint supports pagination with standard URL query parameters . Remember to percent-encode [
as %5B
and ]
as %5D
if your tooling doesn't automatically encode URLs.
Parameter Description include
Optional. Allows including related resource data. Value must be a comma-separated list containing one or more of workspace_tasks
or workspace_tasks.workspace
.page[number]
Optional. If omitted, the endpoint will return the first page.page[size]
Optional. If omitted, the endpoint will return 20 policy sets per page.
» Sample Requestcurl \
--header "Authorization: Bearer $TOKEN " \
https://app.terraform.io/api/v2/organizations/my-organization/tasks
curl \
--header "Authorization: Bearer $TOKEN " \
https://app.terraform.io/api/v2/organizations/my-organization/tasks
» Sample Response{
"data" : [
{
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "my-task" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"enabled" : "true" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [ ]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
] ,
"links" : {
"self" : "https://app.terraform.io/api/v2/organizations/hashicorp/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"first" : "https://app.terraform.io/api/v2/organizations/hashicorp/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"prev" : null ,
"next" : null ,
"last" : "https://app.terraform.io/api/v2/organizations/hashicorp/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20"
} ,
"meta" : {
"pagination" : {
"current-page" : 1 ,
"page-size" : 20 ,
"prev-page" : null ,
"next-page" : null ,
"total-pages" : 1 ,
"total-count" : 1
}
}
}
{
"data" : [
{
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "my-task" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"enabled" : "true" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [ ]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
] ,
"links" : {
"self" : "https://app.terraform.io/api/v2/organizations/hashicorp/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"first" : "https://app.terraform.io/api/v2/organizations/hashicorp/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"prev" : null ,
"next" : null ,
"last" : "https://app.terraform.io/api/v2/organizations/hashicorp/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20"
} ,
"meta" : {
"pagination" : {
"current-page" : 1 ,
"page-size" : 20 ,
"prev-page" : null ,
"next-page" : null ,
"total-pages" : 1 ,
"total-count" : 1
}
}
}
» Show a Run TaskGET /tasks/:id
Parameter Description :id
The ID of the task to show. Use the "List Run Tasks" endpoint to find IDs.
Parameter Description include
Optional. Allows including related resource data. Value must be a comma-separated list containing one or more of workspace_tasks
or workspace_tasks.workspace
.
» Sample Requestcurl --request GET \
-H "Authorization: Bearer $TOKEN " \
-H "Content-Type: application/vnd.api+json" \
https://app.terraform.io/api/v2/tasks/task-7oD7doVTQdAFnMLV
curl --request GET \
-H "Authorization: Bearer $TOKEN " \
-H "Content-Type: application/vnd.api+json" \
https://app.terraform.io/api/v2/tasks/task-7oD7doVTQdAFnMLV
» Sample Response{
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "my-task" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"enabled" : "true" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [
{
"id" : "task-xjKZw9KaeXda61az" ,
"type" : "tasks"
}
]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
}
{
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "my-task" ,
"url" : "http://example.com" ,
"description" : "Simple description" ,
"enabled" : "true" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [
{
"id" : "task-xjKZw9KaeXda61az" ,
"type" : "tasks"
}
]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
}
» Update a Run TaskPATCH /tasks/:id
Parameter Description :id
The ID of the task to update. Use the "List Run Tasks" endpoint to find IDs.
» Request BodyThis PATCH endpoint requires a JSON object with the following properties as a request payload.
Properties without a default value are required unless otherwise specified.
Key path Type Default Description data.type
string Must be "tasks"
. data.attributes.name
string (previous value) The name of the run task. Can include letters, numbers, -
, and _
. data.attributes.url
string (previous value) URL to send a run task payload. data.attributes.description
string The description of the run task. Can include spaces, letters, numbers, and special characters data.attributes.category
string (previous value) Must be "task"
. data.attributes.hmac-key
string (previous value) (Optional) HMAC key to verify run task. data.attributes.enabled
bool (previous value) (Optional) Whether the task will be run.
» Sample Payload{
"data" : {
"type" : "tasks" ,
"attributes" : {
"name" : "new-example" ,
"url" : "http://new-example.com" ,
"description" : "New description" ,
"hmac_key" : "new-secret" ,
"enabled" : "false" ,
"category" : "task"
}
}
}
{
"data" : {
"type" : "tasks" ,
"attributes" : {
"name" : "new-example" ,
"url" : "http://new-example.com" ,
"description" : "New description" ,
"hmac_key" : "new-secret" ,
"enabled" : "false" ,
"category" : "task"
}
}
}
» Sample Requestcurl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request PATCH \
--data @payload.json \
https://app.terraform.io/api/v2/tasks/task-7oD7doVTQdAFnMLV
curl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request PATCH \
--data @payload.json \
https://app.terraform.io/api/v2/tasks/task-7oD7doVTQdAFnMLV
» Sample Response{
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "new-example" ,
"url" : "http://new-example.com" ,
"description" : "New description" ,
"enabled" : "false" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [
{
"id" : "wstask-xjKZw9KaeXda61az" ,
"type" : "workspace-tasks"
}
]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
}
{
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks" ,
"attributes" : {
"category" : "task" ,
"name" : "new-example" ,
"url" : "http://new-example.com" ,
"description" : "New description" ,
"enabled" : "false" ,
"hmac-key" : null ,
} ,
"relationships" : {
"organization" : {
"data" : {
"id" : "hashicorp" ,
"type" : "organizations"
}
} ,
"tasks" : {
"data" : [
{
"id" : "wstask-xjKZw9KaeXda61az" ,
"type" : "workspace-tasks"
}
]
}
} ,
"links" : {
"self" : "/api/v2/tasks/task-7oD7doVTQdAFnMLV"
}
}
}
» Delete a Run TaskDELETE /tasks/:id
Parameter Description :id
The ID of the run task to delete. Use the "List Run Tasks" endpoint to find IDs.
Status Response Reason 204 Nothing Successfully deleted the run task 404 JSON API error object Run task not found, or user unauthorized to perform action
» Sample Requestcurl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request DELETE \
https://app.terraform.io/api/v2/tasks/task-7oD7doVTQdAFnMLV
curl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request DELETE \
https://app.terraform.io/api/v2/tasks/task-7oD7doVTQdAFnMLV
» Attach a Run Task to a WorkspacePOST /workspaces/:workspace_id/tasks
Parameter Description :workspace_id
The ID of the workspace.
» Request BodyThis POST endpoint requires a JSON object with the following properties as a request payload.
Properties without a default value are required.
Key path Type Default Description data.type
string Must be "workspace-tasks"
. data.attributes.enforcement-level
string The enforcement level of the workspace task. Must be "advisory"
or "mandatory"
. data.relationships.task.data.id
string The ID of the run task. data.relationships.task.data.type
string Must be "tasks"
.
» Sample Payload{
"data" : {
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks"
}
}
}
}
}
{
"data" : {
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks"
}
}
}
}
}
» Sample Requestcurl \
-H "Authorization: Bearer $TOKEN " \
-H "Content-Type: application/vnd.api+json" \
--request POST \
--data @payload.json \
https://app.terraform.io/api/v2/workspaces/ws-PphL7ix3yGasYGrq/tasks
curl \
-H "Authorization: Bearer $TOKEN " \
-H "Content-Type: application/vnd.api+json" \
--request POST \
--data @payload.json \
https://app.terraform.io/api/v2/workspaces/ws-PphL7ix3yGasYGrq/tasks
» Sample Response{
"data" : {
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-PphL7ix3yGasYGrq" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-PphL7ix3yGasYGrq/tasks/task-tBXYu8GVAFBpcmPm"
}
}
}
{
"data" : {
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-7oD7doVTQdAFnMLV" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-PphL7ix3yGasYGrq" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-PphL7ix3yGasYGrq/tasks/task-tBXYu8GVAFBpcmPm"
}
}
}
» List Workspace Run TasksGET /workspaces/:workspace_id/tasks
Parameter Description :workspace_id
The workspace to list tasks for.
» Query ParametersThis endpoint supports pagination with standard URL query parameters . Remember to percent-encode [
as %5B
and ]
as %5D
if your tooling doesn't automatically encode URLs.
Parameter Description page[number]
Optional. If omitted, the endpoint will return the first page.page[size]
Optional. If omitted, the endpoint will return 20 policy sets per page.
» Sample Requestcurl \
--header "Authorization: Bearer $TOKEN " \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks
curl \
--header "Authorization: Bearer $TOKEN " \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks
» Sample Response{
"data" : [
{
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-hu74ST39g566Q4m5" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-kRsDRPtTmtcEme4t" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/task-tBXYu8GVAFBpcmPm"
}
}
] ,
"links" : {
"self" : "https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"first" : "https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"prev" : null ,
"next" : null ,
"last" : "https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20"
} ,
"meta" : {
"pagination" : {
"current-page" : 1 ,
"page-size" : 20 ,
"prev-page" : null ,
"next-page" : null ,
"total-pages" : 1 ,
"total-count" : 1
}
}
}
{
"data" : [
{
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-hu74ST39g566Q4m5" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-kRsDRPtTmtcEme4t" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/task-tBXYu8GVAFBpcmPm"
}
}
] ,
"links" : {
"self" : "https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"first" : "https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20" ,
"prev" : null ,
"next" : null ,
"last" : "https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks?page%5Bnumber%5D=1&page%5Bsize%5D=20"
} ,
"meta" : {
"pagination" : {
"current-page" : 1 ,
"page-size" : 20 ,
"prev-page" : null ,
"next-page" : null ,
"total-pages" : 1 ,
"total-count" : 1
}
}
}
» Show Workspace Run TaskGET /workspaces/:workspace_id/tasks/:id
» Sample Requestcurl --request GET \
-H "Authorization: Bearer $TOKEN " \
-H "Content-Type: application/vnd.api+json" \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm
curl --request GET \
-H "Authorization: Bearer $TOKEN " \
-H "Content-Type: application/vnd.api+json" \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm
» Sample Response{
"data" : {
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-hu74ST39g566Q4m5" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-kRsDRPtTmtcEme4t" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm"
}
}
}
{
"data" : {
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "advisory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-hu74ST39g566Q4m5" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-kRsDRPtTmtcEme4t" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm"
}
}
}
» Update Workspace Run TaskPATCH /workspaces/:workspace_id/tasks/:id
» Request BodyThis PATCH endpoint requires a JSON object with the following properties as a request payload.
Properties without a default value are required.
Key path Type Default Description data.type
string (previous value) Must be "workspace-tasks"
. data.attributes.enforcement-level
string (previous value) The enforcement level of the workspace run task. Must be "advisory"
or "mandatory"
.
» Sample Payload{
"data" : {
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "mandatory"
}
}
}
{
"data" : {
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "mandatory"
}
}
}
» Sample Requestcurl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request PATCH \
--data @payload.json \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm
curl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request PATCH \
--data @payload.json \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm
» Sample Response{
"data" : {
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "mandatory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-hu74ST39g566Q4m5" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-kRsDRPtTmtcEme4t" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/task-tBXYu8GVAFBpcmPm"
}
}
}
{
"data" : {
"id" : "wstask-tBXYu8GVAFBpcmPm" ,
"type" : "workspace-tasks" ,
"attributes" : {
"enforcement-level" : "mandatory" ,
"stage" : "post_plan"
} ,
"relationships" : {
"task" : {
"data" : {
"id" : "task-hu74ST39g566Q4m5" ,
"type" : "tasks"
}
} ,
"workspace" : {
"data" : {
"id" : "ws-kRsDRPtTmtcEme4t" ,
"type" : "workspaces"
}
}
} ,
"links" : {
"self" : "/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/task-tBXYu8GVAFBpcmPm"
}
}
}
» Delete Workspace Run TaskDELETE /workspaces/:workspace_id/tasks/:id
Status Response Reason 204 Nothing Successfully deleted the workspace run task 404 JSON API error object Workspace run task not found, or user unauthorized to perform action
» Sample Requestcurl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request DELETE \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm
curl \
--header "Authorization: Bearer $TOKEN " \
--header "Content-Type: application/vnd.api+json" \
--request DELETE \
https://app.terraform.io/api/v2/workspaces/ws-kRsDRPtTmtcEme4t/tasks/wstask-tBXYu8GVAFBpcmPm