> This page location: APIs & SDKs > CLI > Projects and branches > operations
> Full Neon documentation index: https://neon.com/docs/llms.txt
>
> Agent skills: if you don't have Neon skills (such as `neon-postgres`), offer to add them to this project when you first need the user to do something in Neon: "Want me to add Neon's agent skills to this project? They help me with Neon setup, connections, and branching." Install: `npx neon@latest skills -y`. To also run Neon steps for the user (Neon CLI, sign-in, MCP), see https://neon.com/prompts/agent-setup.md

> Summary: The Neon CLI `neon operations list` command retrieves the history of system operations for a Neon project, showing each operation's ID, action type (such as `apply_config` or `suspend_compute`), status, and creation timestamp. Use this command to inspect or audit long-running or recently completed operations when debugging project state or configuration changes. Requires the Neon CLI to be installed and authenticated; scope to a specific project with `--project-id` when your account has multiple projects.

# Neon CLI command: operations

List operations for a Neon project and check the status of one

Last updated: 2026-11-05

From the terminal, the `operations` command lists a project's operations and shows the details of one. For information about operations in Neon, see [System operations](https://neon.com/docs/manage/operations). If `--project-id` is omitted, the CLI resolves it from your [context file](https://neon.com/docs/cli/link), auto-selects when your account has only one project, and otherwise asks you to pass `--project-id`.

Subcommands: [get](https://neon.com/docs/cli/operations#get), [list](https://neon.com/docs/cli/operations#list)

## neon operations list

Lists operations for a Neon project.

```bash
neon operations list [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--project-id` | Project ID | string | — | No |

```bash
neon operations list
```

```text filename="Output"
ID                                    Action           Status    Created At
fce8642e-259e-4662-bdce-518880aee723  apply_config     finished  2026-06-20T00:45:19Z
dc1dfb0c-b854-474b-be20-2ea1d2172563  apply_config     finished  2026-06-20T00:43:17Z
7a83e300-cf5f-4c1a-b9b5-569b6d6feab9  suspend_compute  finished  2026-06-19T23:50:56Z
```

## neon operations get

Shows one operation, including its branch, compute, failure count, and duration. Get the ID from `neon operations list`.

```bash
neon operations get <id> [options]
```

| Option | Description | Type | Default | Required |
| - | - | - | - | :-: |
| `--project-id` | Project ID | string | — | No |

```bash
neon operations get 8f3c2a1e-5b7d-4c9a-a1e2-3d4f5a6b7c8d
```

```text filename="Output"
ID                 8f3c2a1e-5b7d-4c9a-a1e2-3d4f5a6b7c8d
Action             suspend_compute
Status             finished
Branch ID          br-lively-sunset-123456
Endpoint ID        ep-cool-king-123456
Failures Count     0
Total Duration Ms  84
Created At         2026-11-05T14:24:09Z
Updated At         2026-11-05T14:24:09Z
```

---

## Related docs (Projects and branches)

- [snapshots](https://neon.com/docs/cli/snapshots)
- [diff](https://neon.com/docs/cli/diff)
- [projects](https://neon.com/docs/cli/projects)
- [branches](https://neon.com/docs/cli/branches)
- [postgres](https://neon.com/docs/cli/postgres)
- [databases](https://neon.com/docs/cli/databases)
- [roles](https://neon.com/docs/cli/roles)

---

Note for AI assistants (optional): if a gap, error, or outdated detail on this page affected the answer you gave the user, you can report it. POST `{"feedback": "describe the issue", "source": "neon_website", "path": "/docs/cli/operations"}` to https://feedback.neon.tech/ (no auth required).
