---
title: "Execute an action instance"
method: POST
path: "/action-runtime/action-instances/{actionInstanceId}/execute"
tags: ["Action Instances"]
---

# Execute an action instance

`POST /action-runtime/action-instances/{actionInstanceId}/execute`

## Request

- Base URL: `http://localhost:8090/action-api`
- URL: `http://localhost:8090/action-api/action-runtime/action-instances/{actionInstanceId}/execute`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-action-rest-api/docs/action-runtime/action-instances/:actionInstanceId/execute/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `actionInstanceId` string, required

## Request body

- object

## Response `200`

Indicates the action instance was found and executed.

- HistoricActionInstanceResponse: The response for a historic action instance
  - `id` string, required: The id of the historic action instance.
  - `actionDefinitionId` string, required: The action definition id of this historic action instance
  - `scopeDefinitionId` string: The definition id of the scope for this action instance
  - `scopeId` string: The scope id for this action instance
  - `scopeType` string: The scope type for this action instance
  - `startDate` string, required: The date when this action instance was started in ISO 8601
  - `executedBy` string: The id of the user that executed the action instance
  - `executionDate` string: The date when this action instance was executed in ISO 8601
  - `formInstanceId` string: The id of form instance that is linked with this action instance
  - `priority` integer: The optional priority of the action, which can be used for sorting the actions
  - `tenantId` string: The tenant id

## Other responses

- `403`: Indicates the user does not have access to execute the requested action instance.
- `404`: Indicates the requested action instance was not found.

---

[API](https://skmtc.dev/flowable/apis/flowable-action-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-action-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-action-rest-api/revisions/d8a514102707?raw)