> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TriggerPurchaseOrderActionEventCommandRequestInput

> Raises the automatic workflow event of a purchase order that belongs to an action (for example created, released or changed), so that the workflows that react to it run. Use it after a write that was sent with disableAutomaticWorkflows=true; every write of purchase orders names the keys of the events it raises, or that it raises none. The workflows run asynchronously; their result is not reported back, read the workflow queue and log (QueryWorkflowQueueEntries, QueryWorkflowLogEntries) for it. The action keys a kind of record supports are a catalogue in the workflow API design document, not an enum, so new actions are added without a contract change. Errors arrive as GraphQL errors with the code in 'extensions.code'. Codes: PURCHASE_ORDER_NOT_FOUND (the order was not found); WORKFLOW_ACTION_UNKNOWN (the key is not in the catalogue of purchase orders); WORKFLOW_ACTION_NOT_AVAILABLE (the key is known, but the workflow engine has no such event for purchase orders); WORKFLOWS_NOT_LICENSED (the license does not include workflows). - Request



**Kind**: `input`

## Fields

**`purchaseOrderId`**: `ID!` (required)

The ID of the purchase order.

---

**`actionKey`**: `String!` (required)

The key of the action whose automatic event is raised, for example created, released or changed. The keys a purchase order supports are listed in the workflow API design document.

---

**`idempotencyKey`**: `String`

Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.