capabilities.work

Run an AI Action

A 4-step recipe with Zapier. We can help you get access.

Recipe · 4 steps

Run an AI Action

with Zapier

Run a single Zapier action against a third-party app and retrieve its result.

  1. Fetch the actions available for the app so the target action id can be confirmed before running it.
  2. Read the input field definitions for the target action so the caller knows which inputs are required before running it.
  3. Create an asynchronous action run with the supplied authentication and inputs. The response returns the run id to poll.
  4. Retrieve the action run and branch on its status: re-poll while it is still running, end on success, and surface a failure on error.
What you'll need to have ready
  • accessToken: OAuth2 bearer token used in the Authorization header.
  • appId: Canonical App ID (UUID) as provided by the /apps endpoint.
  • actionId: The Action ID to run (e.g. uag:87b1c14e-ef30-43d5-9395-6c6514dbb123).
  • authentication: The Authentication ID that grants access to the third-party app.
  • inputs: Map of input field id/value pairs to pass to the action.
For your developer

Arazzo workflow zapier:run-ai-action, 4 operations: get-actions → get-fields-inputs → create-action-run → retrieve-action-run. Specs on APIs.io.