---
title: "One automation in full, its steps included"
method: GET
path: "/api/v1/automations/{id}"
tags: ["Automations"]
---

# One automation in full, its steps included

`GET /api/v1/automations/{id}`

## Request

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

Read one of the user's automations in full: its name, what it does, when it runs, its status, the next run, its steps as written (the Markdown a run follows; empty for a draft or a fixed action) and how the last run ended. Use it for "what does my Monday digest actually do", or before explaining or starting one; list_automations is the directory, get_automation_runs the runs.

## Path parameters

- `id` string, required

## Response `200`

The tool's result.

- object
  - `id` string, required
  - `name` string, required
  - `status` string, required
  - `when` string, required
  - `nextRunAt` string, nullable, required
  - `steps` string, required: The steps as written, Markdown; empty when there are none.
  - `webUrl` 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)