Creating Your First Action

An action is defined by an action application and implements functionality end-to-end, such as merging a change on Jenkins, getting the last 10 git commits, or updating the StatusPage incident page.

You may also need to set up authorization and some configuration in order for the application to run.

An action can be triggered with authentication in a runbook. When you create an action application, you are creating a action that can be added to any runbook.

Note: Before creating a new action, be aware that Transposit comes with a wide range of actions built-in, as described in Adding Runbook Actions.

Follow the steps below to create your first action in Python, though note that JavaScript support is also available.

  1. Fork sample application. Go to this sample application and click "Fork this app" at the top of the page. Make sure to change the owner to the name of your team, not your personal account.
  2. Deploy application. In your application in the Transposit Developer Platform, go to Deploy > Mission Control and select your input (named input_prompt) and execution operations (named execute). The type should be "Action". You should use the latest tag for ease of development.
  3. Create a runbook. Go back to the main Transposit site. In the top navigation, go to the Runbooks section. Create a New runbook.
  4. Add the action. Select +Add action to add an action, select My Applications and select the application you just created. Your application needs to be deployed to show up in the application picker. If you don’t see it, make sure you completed step 2, while also making sure to Save your runbook.
  5. Test your action. Click on the top Runbooks tab. Find your runbook and click Run.

If you make a change to a runbook, you'll need to start a new runbook run (Step 5) to pick up the changes. In Slack, use /transposit to browse and start runbooks.

If you want to better understand the operations that actions use, learn error handling best practices, learn more about authentication, and more action-related concepts, see Action Concepts & Best Practices.