---
title: "Execute Automation"
method: POST
path: "/automations/execute"
tags: ["automations"]
---

# Execute Automation

`POST /automations/execute`

## Request

- Base URL: `https://api.data.world/v0`
- URL: `https://api.data.world/v0/automations/execute`
- Auth: HTTP bearer

Triggers a "Start Process" automation that has already been configured for the organization. This enqueues the automation for asynchronous execution; it does not run the automation synchronously. The response is returned as soon as the automation has been queued, not once it has finished running.The automation to run is identified by its operation IRI, which can be found by getting or searching for a metadata resource through the API. Automations that are not categorized as "Start Process" operations are rejected.Access requirement: Requires an admin token. It also requires admin access to the organization.

## Request body

- ExecuteAutomationRequestDto
  - `operationIri` string, required: Operation IRI identifying which automation to execute, of the form "system:automation/{automationId}/.../Operation". Found by getting or searching for a metadata resource. Only the automation id embedded in this IRI is used to identify the automation; the automation's own stored configuration determines the operation that runs.
  - `orgAgentId` string, required: Organization agent ID that owns the automation to execute.
  - `resourceIri` string, required: IRI of the metadata resource the automation should act on.

## Response `202`

Accepted

- SuccessMessage
  - `message` string

## Other responses

- `400`: Bad Request
- `401`: User is unauthorized to perform action
- `403`: Access forbidden
- `404`: Not found
- `500`: Server error

## Changes

- **2026-11-03** `a1f78a95dfc1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/data/apis/data-world-public-api/changes/automations/execute/post.md)

---

[API](https://skmtc.dev/data/apis/data-world-public-api.md) - [All operations](https://skmtc.dev/data/apis/data-world-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/data/apis/data-world-public-api/revisions/a1f78a95dfc1?raw)