---
title: "Start an automation now"
method: POST
path: "/api/v1/automations/{id}/run"
tags: ["Automations"]
---

# Start an automation now

`POST /api/v1/automations/{id}/run`

## Request

- Base URL: `https://api.roma.app`
- URL: `https://api.roma.app/api/v1/automations/{id}/run`
- Auth: HTTP bearer

Start one of the user's automations now — the same as Run now on its page in Roma. Use it only when the user asks to run a specific automation. The run happens inside Roma with the user's connected apps and can take a minute; its result lands in the user's Roma chat, not in this conversation. Read the outcome afterwards with get_automation_runs. Refused for a draft, while the same automation is already running, or once the daily run limit is reached.

## Path parameters

- `id` string, required

## Response `200`

The tool's result.

- object
  - `id` string, required
  - `name` string, required
  - `runId` string, required
  - `status` string, required

## Other responses

- `400`: The request was understood and refused; the error says what to change.
- `401`: No usable bearer token.
- `404`: No such item for this account.
- `405`: The path exists but not with this method; Allow lists the ones that work.
- `429`: Over the rate limit; wait for Retry-After.

---

[API](https://skmtc.dev/roma/apis/roma-api.md) - [All operations](https://skmtc.dev/roma/apis/roma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roma/apis/roma-api/revisions/3dd91459b0fb?raw)