openapi: 3.2.0 info: title: AWX Workflow Jobs API version: v2 description: AWX API Documentation contact: email: ansible-community@redhat.com license: name: Apache License tags: - name: Workflow Jobs paths: /api/v2/workflow_jobs/: get: operationId: workflow_jobs_list parameters: - in: query name: order schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - in: query name: order_by schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - name: page required: false in: query description: A page number within the paginated result set. schema: type: integer - name: page_size required: false in: query description: Number of results to return per page. schema: type: integer - in: query name: role_level schema: type: string description: Filter by role level for RBAC - name: search required: false in: query description: A search term. schema: type: string - in: query name: type schema: type: string description: Filter by object type. Supports comma-separated values for multiple types. tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedWorkflowJobListList' description: '' x-ai-description: A list of workflow jobs. summary: Workflow jobs list x-summary-source: derived /api/v2/workflow_jobs/{id}/: get: operationId: workflow_jobs_retrieve description: Special handling when deleting a running unified job object. parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/WorkflowJob' description: '' x-ai-description: Retrieve a workflow job summary: Workflow jobs retrieve x-summary-source: derived delete: operationId: workflow_jobs_destroy description: Special handling when deleting a running unified job object. parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true tags: - Workflow Jobs responses: '204': description: No response body x-ai-description: Delete a workflow job summary: Workflow jobs destroy x-summary-source: derived /api/v2/workflow_jobs/{id}/activity_stream/: get: operationId: workflow_jobs_activity_stream_list parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true - in: query name: order schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - in: query name: order_by schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - name: page required: false in: query description: A page number within the paginated result set. schema: type: integer - name: page_size required: false in: query description: Number of results to return per page. schema: type: integer - in: query name: role_level schema: type: string description: Filter by role level for RBAC - name: search required: false in: query description: A search term. schema: type: string - in: query name: type schema: type: string description: Filter by object type. Supports comma-separated values for multiple types. tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedActivityStreamList' description: '' x-ai-description: List activity stream of a workflow job summary: Workflow jobs activity stream list x-summary-source: derived /api/v2/workflow_jobs/{id}/cancel/: get: operationId: workflow_jobs_cancel_retrieve parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/WorkflowJobCancel' description: '' x-ai-description: Retrieve a cancel for a workflow job summary: Workflow jobs cancel retrieve x-summary-source: derived post: operationId: workflow_jobs_cancel_create parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/WorkflowJobCancel' description: '' x-ai-description: Cancel a running or pending workflow job summary: Workflow jobs cancel create x-summary-source: derived /api/v2/workflow_jobs/{id}/labels/: get: operationId: workflow_jobs_labels_list parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true - in: query name: order schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - in: query name: order_by schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - name: page required: false in: query description: A page number within the paginated result set. schema: type: integer - name: page_size required: false in: query description: Number of results to return per page. schema: type: integer - in: query name: role_level schema: type: string description: Filter by role level for RBAC - name: search required: false in: query description: A search term. schema: type: string - in: query name: type schema: type: string description: Filter by object type. Supports comma-separated values for multiple types. tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedLabelList' description: '' x-ai-description: List labels of a workflow job summary: Workflow jobs labels list x-summary-source: derived /api/v2/workflow_jobs/{id}/notifications/: get: operationId: workflow_jobs_notifications_list parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true - in: query name: order schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - in: query name: order_by schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - name: page required: false in: query description: A page number within the paginated result set. schema: type: integer - name: page_size required: false in: query description: Number of results to return per page. schema: type: integer - in: query name: role_level schema: type: string description: Filter by role level for RBAC - name: search required: false in: query description: A search term. schema: type: string - in: query name: type schema: type: string description: Filter by object type. Supports comma-separated values for multiple types. tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedNotificationList' description: '' x-ai-description: List notifications of a workflow job summary: Workflow jobs notifications list x-summary-source: derived /api/v2/workflow_jobs/{id}/relaunch/: get: operationId: workflow_jobs_relaunch_retrieve parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true tags: - Workflow Jobs responses: '200': description: No response body x-ai-description: Get workflow job relaunch information summary: Workflow jobs relaunch retrieve x-summary-source: derived post: operationId: workflow_jobs_relaunch_create parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true tags: - Workflow Jobs responses: '200': description: No response body x-ai-description: Relaunch a previously completed or failed workflow job using the same parameters as the original run. summary: Workflow jobs relaunch create x-summary-source: derived /api/v2/workflow_jobs/{id}/workflow_nodes/: get: operationId: workflow_jobs_workflow_nodes_list parameters: - in: path name: id schema: type: string pattern: ^[0-9]+$ required: true - in: query name: order schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - in: query name: order_by schema: type: string description: Order results by field name. Prefix with '-' for descending order. Supports comma-separated values for multiple fields. - name: page required: false in: query description: A page number within the paginated result set. schema: type: integer - name: page_size required: false in: query description: Number of results to return per page. schema: type: integer - in: query name: role_level schema: type: string description: Filter by role level for RBAC - name: search required: false in: query description: A search term. schema: type: string - in: query name: type schema: type: string description: Filter by object type. Supports comma-separated values for multiple types. tags: - Workflow Jobs responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedWorkflowJobNodeListList' description: '' x-ai-description: List workflow nodes of a workflow job summary: Workflow jobs workflow nodes list x-summary-source: derived components: schemas: WorkflowJobNodeList: type: object properties: id: type: integer readOnly: true type: type: string readOnly: true url: type: string readOnly: true related: type: string readOnly: true summary_fields: type: string readOnly: true created: type: string readOnly: true modified: type: string readOnly: true extra_data: default: {} inventory: type: - integer - 'null' description: Inventory applied as a prompt, assuming job template prompts for inventory scm_branch: type: - string - 'null' job_type: enum: - run - check - '' - null type: - string - 'null' description: '* `run` - Run * `check` - Check' x-spec-enum-id: 726608a431c1f104 job_tags: type: - string - 'null' skip_tags: type: - string - 'null' limit: type: - string - 'null' diff_mode: type: - boolean - 'null' verbosity: enum: - 0 - 1 - 2 - 3 - 4 - 5 - null type: - integer - 'null' description: '* `0` - 0 (Normal) * `1` - 1 (Verbose) * `2` - 2 (More Verbose) * `3` - 3 (Debug) * `4` - 4 (Connection Debug) * `5` - 5 (WinRM Debug)' x-spec-enum-id: 8cfb81af905b865a execution_environment: type: - integer - 'null' description: The container image to be used for execution. forks: type: - integer - 'null' minimum: 0 job_slice_count: type: - integer - 'null' minimum: 0 timeout: type: - integer - 'null' job: type: - integer - 'null' workflow_job: type: - integer - 'null' unified_job_template: type: - integer - 'null' success_nodes: type: array items: type: integer readOnly: true failure_nodes: type: array items: type: integer readOnly: true always_nodes: type: array items: type: integer readOnly: true all_parents_must_converge: type: - boolean - 'null' default: false description: If enabled then the node will only run if all of the parent nodes have met the criteria to reach this node do_not_run: type: - boolean - 'null' default: false description: Indicates that a job will not be created when True. Workflow runtime semantics will mark this True if the node is in a path that will decidedly not be ran. A value of False means the node may not run. identifier: type: - string - 'null' description: An identifier coresponding to the workflow job template node that this node was created from. maxLength: 512 PaginatedWorkflowJobListList: type: object required: - count - results properties: count: type: integer example: 123 next: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=4 previous: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=2 results: type: array items: $ref: '#/components/schemas/WorkflowJobList' Label: type: object properties: id: type: integer readOnly: true type: type: string readOnly: true url: type: string readOnly: true related: type: string readOnly: true summary_fields: type: string readOnly: true created: type: string readOnly: true modified: type: string readOnly: true name: type: - string - 'null' maxLength: 512 organization: type: integer description: Organization this label belongs to. required: - name - organization PaginatedLabelList: type: object required: - count - results properties: count: type: integer example: 123 next: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=4 previous: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=2 results: type: array items: $ref: '#/components/schemas/Label' PaginatedNotificationList: type: object required: - count - results properties: count: type: integer example: 123 next: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=4 previous: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=2 results: type: array items: $ref: '#/components/schemas/Notification' Notification: type: object properties: id: type: integer readOnly: true type: type: string readOnly: true url: type: string readOnly: true related: type: string readOnly: true summary_fields: type: string readOnly: true created: type: string readOnly: true modified: type: string readOnly: true notification_template: type: integer readOnly: true error: type: string readOnly: true status: enum: - pending - successful - failed type: string description: '* `pending` - Pending * `successful` - Successful * `failed` - Failed' x-spec-enum-id: 91d6a0571e1ae0e7 readOnly: true notifications_sent: type: integer readOnly: true notification_type: enum: - awssns - email - grafana - irc - mattermost - pagerduty - rocketchat - slack - twilio - webhook - null type: - string - 'null' description: '* `awssns` - AWS SNS * `email` - Email * `grafana` - Grafana * `irc` - IRC * `mattermost` - Mattermost * `pagerduty` - Pagerduty * `rocketchat` - Rocket.Chat * `slack` - Slack * `twilio` - Twilio * `webhook` - Webhook' x-spec-enum-id: 867d131dea32a033 recipients: type: string readOnly: true subject: type: string readOnly: true body: type: string readOnly: true description: Notification body required: - notification_type WorkflowJob: type: object properties: id: type: integer readOnly: true type: type: string readOnly: true url: type: string readOnly: true related: type: string readOnly: true summary_fields: type: string readOnly: true created: type: string readOnly: true modified: type: string readOnly: true name: type: - string - 'null' maxLength: 512 description: type: - string - 'null' default: '' unified_job_template: type: - integer - 'null' readOnly: true launch_type: enum: - manual - relaunch - callback - scheduled - dependency - workflow - webhook - sync - scm type: string description: '* `manual` - Manual * `relaunch` - Relaunch * `callback` - Callback * `scheduled` - Scheduled * `dependency` - Dependency * `workflow` - Workflow * `webhook` - Webhook * `sync` - Sync * `scm` - SCM Update' x-spec-enum-id: e5bed25c2e652da3 readOnly: true status: enum: - new - pending - waiting - running - successful - failed - error - canceled type: string description: '* `new` - New * `pending` - Pending * `waiting` - Waiting * `running` - Running * `successful` - Successful * `failed` - Failed * `error` - Error * `canceled` - Canceled' x-spec-enum-id: 6021859c28387823 readOnly: true failed: type: boolean readOnly: true started: type: - string - 'null' format: date-time readOnly: true description: The date and time the job was queued for starting. finished: type: - string - 'null' format: date-time readOnly: true description: The date and time the job finished execution. canceled_on: type: - string - 'null' format: date-time readOnly: true description: The date and time when the cancel request was sent. elapsed: type: string format: decimal pattern: ^-?\d{0,9}(?:\.\d{0,3})?$ readOnly: true description: Elapsed time in seconds that the job ran. job_args: type: string readOnly: true job_cwd: type: string readOnly: true job_env: readOnly: true job_explanation: type: string readOnly: true description: A status field to indicate the state of the job if it wasn't able to run and capture stdout result_traceback: type: string readOnly: true launched_by: type: string readOnly: true work_unit_id: type: - string - 'null' readOnly: true description: The Receptor work unit ID associated with this job. workflow_job_template: type: - integer - 'null' extra_vars: type: - string - 'null' default: '' allow_simultaneous: type: - boolean - 'null' default: false job_template: type: - integer - 'null' description: If automatically created for a sliced job run, the job template the workflow job was created from. is_sliced_job: type: - boolean - 'null' default: false inventory: type: - integer - 'null' description: Inventory applied as a prompt, assuming job template prompts for inventory limit: type: - string - 'null' scm_branch: type: - string - 'null' webhook_service: enum: - github - gitlab - bitbucket_dc - '' - null type: - string - 'null' x-spec-enum-id: eee3a42406ba2781 description: 'Service that webhook requests will be accepted from * `github` - GitHub * `gitlab` - GitLab * `bitbucket_dc` - BitBucket DataCenter' webhook_credential: type: - integer - 'null' description: Personal Access Token for posting back the status to the service API webhook_guid: type: - string - 'null' description: Unique identifier of the event that triggered this webhook maxLength: 128 skip_tags: type: - string - 'null' job_tags: type: - string - 'null' required: - name ActivityStream: type: object properties: id: type: integer readOnly: true type: type: string readOnly: true url: type: string readOnly: true related: type: string readOnly: true summary_fields: type: string readOnly: true timestamp: type: string format: date-time readOnly: true operation: enum: - create - update - delete - associate - disassociate - null type: - string - 'null' x-spec-enum-id: d1cf1307b8aa394e description: 'The action taken with respect to the given object(s). * `create` - Entity Created * `update` - Entity Updated * `delete` - Entity Deleted * `associate` - Entity Associated with another Entity * `disassociate` - Entity was Disassociated with another Entity' changes: type: string readOnly: true description: A summary of the new and changed values when an object is created, updated, or deleted object1: type: - string - 'null' description: For create, update, and delete events this is the object type that was affected. For associate and disassociate events this is the object type associated or disassociated with object2. object2: type: - string - 'null' description: Unpopulated for create, update, and delete events. For associate and disassociate events this is the object type that object1 is being associated with. object_association: type: string readOnly: true description: When present, shows the field name of the role or relationship that changed. action_node: type: string readOnly: true description: The cluster node the activity took place on. object_type: type: string readOnly: true description: When present, shows the model on which the role or relationship was defined. required: - object1 - object2 - operation PaginatedWorkflowJobNodeListList: type: object required: - count - results properties: count: type: integer example: 123 next: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=4 previous: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=2 results: type: array items: $ref: '#/components/schemas/WorkflowJobNodeList' WorkflowJobCancel: type: object properties: can_cancel: type: boolean readOnly: true WorkflowJobList: type: object properties: id: type: integer readOnly: true type: type: string readOnly: true url: type: string readOnly: true related: type: string readOnly: true summary_fields: type: string readOnly: true created: type: string readOnly: true modified: type: string readOnly: true name: type: - string - 'null' maxLength: 512 description: type: - string - 'null' default: '' unified_job_template: type: - integer - 'null' readOnly: true launch_type: enum: - manual - relaunch - callback - scheduled - dependency - workflow - webhook - sync - scm type: string description: '* `manual` - Manual * `relaunch` - Relaunch * `callback` - Callback * `scheduled` - Scheduled * `dependency` - Dependency * `workflow` - Workflow * `webhook` - Webhook * `sync` - Sync * `scm` - SCM Update' x-spec-enum-id: e5bed25c2e652da3 readOnly: true status: enum: - new - pending - waiting - running - successful - failed - error - canceled type: string description: '* `new` - New * `pending` - Pending * `waiting` - Waiting * `running` - Running * `successful` - Successful * `failed` - Failed * `error` - Error * `canceled` - Canceled' x-spec-enum-id: 6021859c28387823 readOnly: true failed: type: boolean readOnly: true started: type: - string - 'null' format: date-time readOnly: true description: The date and time the job was queued for starting. finished: type: - string - 'null' format: date-time readOnly: true description: The date and time the job finished execution. canceled_on: type: - string - 'null' format: date-time readOnly: true description: The date and time when the cancel request was sent. elapsed: type: string format: decimal pattern: ^-?\d{0,9}(?:\.\d{0,3})?$ readOnly: true description: Elapsed time in seconds that the job ran. job_explanation: type: string readOnly: true description: A status field to indicate the state of the job if it wasn't able to run and capture stdout launched_by: type: string readOnly: true work_unit_id: type: - string - 'null' readOnly: true description: The Receptor work unit ID associated with this job. workflow_job_template: type: - integer - 'null' extra_vars: type: - string - 'null' default: '' allow_simultaneous: type: - boolean - 'null' default: false job_template: type: - integer - 'null' description: If automatically created for a sliced job run, the job template the workflow job was created from. is_sliced_job: type: - boolean - 'null' default: false inventory: type: - integer - 'null' description: Inventory applied as a prompt, assuming job template prompts for inventory limit: type: - string - 'null' scm_branch: type: - string - 'null' webhook_service: enum: - github - gitlab - bitbucket_dc - '' - null type: - string - 'null' x-spec-enum-id: eee3a42406ba2781 description: 'Service that webhook requests will be accepted from * `github` - GitHub * `gitlab` - GitLab * `bitbucket_dc` - BitBucket DataCenter' webhook_credential: type: - integer - 'null' description: Personal Access Token for posting back the status to the service API webhook_guid: type: - string - 'null' description: Unique identifier of the event that triggered this webhook maxLength: 128 skip_tags: type: - string - 'null' job_tags: type: - string - 'null' required: - name PaginatedActivityStreamList: type: object required: - count - results properties: count: type: integer example: 123 next: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=4 previous: type: - string - 'null' format: uri example: http://api.example.org/accounts/?page=2 results: type: array items: $ref: '#/components/schemas/ActivityStream'