---
title: Ansible job actions
source: https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/ansible/ansible-job
---

This page provides a reference for all Ansible job actions available in the workflow automation actions catalog. Use these actions to launch and monitor Ansible Automation Platform (Automation Controller) job templates from your workflows.

## Prerequisites

Before using Ansible actions in workflow automation, you need:

-   An Ansible Automation Platform (Automation Controller) instance accessible over HTTPS.
-   An OAuth2 token with write scope to launch jobs (create one under **Automation Controller > Users > Tokens**).
-   A numeric job template ID for the template you want to launch.
-   The `ask_*_on_launch` setting enabled on the job template for each optional input you plan to use (`extraVars`, `limit`, `inventory`).

## Job actions

The following table lists all available Ansible job actions.

| Action identifier       | Description                                                                       | Reference                                                                                                                                                |
| ----------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ansible.job.launch`    | Launches an Ansible Automation Platform job template and returns the created job. | [Launch an Ansible job template](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/ansible/ansible-job-launch)      |
| `ansible.job.getStatus` | Gets the status and details of a running or completed Ansible job.                | [Get the status of an Ansible job](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/ansible/ansible-job-getstatus) |