> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/api-reference/reference/objects/action.md).

# The action object

The action object in the Shortcut API - every field, an example, and the endpoints that return it.

A write waiting for, or decided by, a person.

## Fields

| Field           | Type                                                                | Description                                                                                                                                                                                                                                                                                                                                                                    |
| --------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`            | id                                                                  | The action's id. `GET /v1/actions/{id}` (MCP `get_action`) says where it stands.                                                                                                                                                                                                                                                                                               |
| `object`        | `"action"`                                                          | Always `action`.                                                                                                                                                                                                                                                                                                                                                               |
| `status`        | `pending`, `approved`, `rejected`, `expired`, `succeeded`, `failed` | `pending`: waiting for a company admin. `approved`: approved and running; one still `approved` after five minutes was interrupted, and a company admin can try it again in Settings (a write that already went through is not repeated). `succeeded` or `failed`: it ran; `result` has the response. `rejected`: the admin said no. `expired`: nobody decided within 72 hours. |
| `operation`     | string                                                              | The operation that was asked for, e.g. `estimates.send`.                                                                                                                                                                                                                                                                                                                       |
| `summary`       | string                                                              | What will happen, in a sentence.                                                                                                                                                                                                                                                                                                                                               |
| `area`          | string                                                              | The area whose level asked for approval, e.g. `messages`.                                                                                                                                                                                                                                                                                                                      |
| `preview`       | any or null                                                         | What the write would return, from a dry run, when the operation has one; null otherwise.                                                                                                                                                                                                                                                                                       |
| `approvalUrl`   | string                                                              | Where a company admin approves or rejects it. Share it with the person you are working for.                                                                                                                                                                                                                                                                                    |
| `createdAt`     | timestamp                                                           | When it was asked for, ISO 8601 in UTC.                                                                                                                                                                                                                                                                                                                                        |
| `expiresAt`     | timestamp                                                           | When it stops being approvable.                                                                                                                                                                                                                                                                                                                                                |
| `decidedAt`     | timestamp or null                                                   | When it was approved or rejected.                                                                                                                                                                                                                                                                                                                                              |
| `result`        | object or null                                                      | The write's response once it ran; null before.                                                                                                                                                                                                                                                                                                                                 |
| `result.status` | integer                                                             | The HTTP status the write answered with.                                                                                                                                                                                                                                                                                                                                       |
| `result.body`   | any                                                                 | The write's response body, as the operation itself returns it.                                                                                                                                                                                                                                                                                                                 |

## Example

```json
{
  "id": "45d1d887-421c-43ce-8e66-4f153ab08a5c",
  "object": "action",
  "status": "pending",
  "operation": "Example operation",
  "summary": "Example summary",
  "area": "Example area",
  "preview": null,
  "approvalUrl": "https://example.com/shortcut/webhooks",
  "createdAt": "2026-10-16T17:04:12.381Z",
  "expiresAt": "2026-10-16T17:04:12.381Z",
  "decidedAt": null,
  "result": {
    "status": 1,
    "body": null
  }
}
```

## Endpoints

| Endpoint               | What it does                   |
| ---------------------- | ------------------------------ |
| `GET /v1/actions`      | List this connection's actions |
| `GET /v1/actions/{id}` | Get an action                  |
