Update a Workflow Job Template
patch
/api/v2/workflow_job_templates/{id}/
Make a PUT or PATCH request to this resource to update this workflow job template. The following fields may be modified:
name
: Name of this workflow job template. (string, required)-
description
: Optional description of this workflow job template. (string, default=""
) -
extra_vars
: (json, default=``) organization
: The organization used to determine access to this template. (id, default=``)survey_enabled
: (boolean, default=False
)allow_simultaneous
: (boolean, default=False
)ask_variables_on_launch
: (boolean, default=False
)inventory
: Inventory applied as a prompt, assuming job template prompts for inventory (id, default=``)limit
: (string, default=""
)scm_branch
: (string, default=""
)ask_inventory_on_launch
: (boolean, default=False
)ask_scm_branch_on_launch
: (boolean, default=False
)ask_limit_on_launch
: (boolean, default=False
)webhook_service
: Service that webhook requests will be accepted from (choice)""
: ---------github
: GitHubgitlab
: GitLab
webhook_credential
: Personal Access Token for posting back the status to the service API (id, default=``)
For a PATCH request, include only the fields that are being modified.
Request
Supported Media Types
- application/json
Path Parameters
Query Parameters
-
search: string
A search term.
Root Schema : schema
Example:
{
"name":"foooooo"
}
Response
Supported Media Types
- application/json
200 Response
Example Response (application/json)
{
"allow_simultaneous":false,
"ask_inventory_on_launch":false,
"ask_limit_on_launch":false,
"ask_scm_branch_on_launch":false,
"ask_variables_on_launch":false,
"created":"2018-02-01T08:00:00.000000Z",
"description":"",
"extra_vars":"",
"id":"1",
"inventory":null,
"last_job_failed":false,
"last_job_run":null,
"limit":null,
"modified":"2018-02-01T08:00:00.000000Z",
"name":"foooooo",
"next_job_run":null,
"organization":"1",
"related":{
"access_list":"/api/v2/workflow_job_templates/1/access_list/",
"activity_stream":"/api/v2/workflow_job_templates/1/activity_stream/",
"copy":"/api/v2/workflow_job_templates/1/copy/",
"labels":"/api/v2/workflow_job_templates/1/labels/",
"launch":"/api/v2/workflow_job_templates/1/launch/",
"notification_templates_approvals":"/api/v2/workflow_job_templates/1/notification_templates_approvals/",
"notification_templates_error":"/api/v2/workflow_job_templates/1/notification_templates_error/",
"notification_templates_started":"/api/v2/workflow_job_templates/1/notification_templates_started/",
"notification_templates_success":"/api/v2/workflow_job_templates/1/notification_templates_success/",
"object_roles":"/api/v2/workflow_job_templates/1/object_roles/",
"organization":"/api/v2/organizations/1/",
"schedules":"/api/v2/workflow_job_templates/1/schedules/",
"survey_spec":"/api/v2/workflow_job_templates/1/survey_spec/",
"webhook_key":"/api/v2/workflow_job_templates/1/webhook_key/",
"webhook_receiver":"",
"workflow_jobs":"/api/v2/workflow_job_templates/1/workflow_jobs/",
"workflow_nodes":"/api/v2/workflow_job_templates/1/workflow_nodes/"
},
"scm_branch":null,
"status":"never updated",
"summary_fields":{
"labels":{
"count":"0",
"results":[
]
},
"object_roles":{
"admin_role":{
"description":"Can manage all aspects of the workflow job template",
"id":"16",
"name":"Admin"
},
"approval_role":{
"description":"Can approve or deny a workflow approval node",
"id":"19",
"name":"Approve"
},
"execute_role":{
"description":"May run the workflow job template",
"id":"17",
"name":"Execute"
},
"read_role":{
"description":"May view settings for the workflow job template",
"id":"18",
"name":"Read"
}
},
"organization":{
"description":"test-org-desc",
"id":"1",
"name":"test-org"
},
"recent_jobs":[
],
"user_capabilities":{
"copy":true,
"delete":true,
"edit":true,
"schedule":true,
"start":true
}
},
"survey_enabled":false,
"type":"workflow_job_template",
"url":"/api/v2/workflow_job_templates/1/",
"webhook_credential":null,
"webhook_service":""
}