> ## Documentation Index
> Fetch the complete documentation index at: https://help.suggix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Post Status Changes Trigger

> Retrieve recent Suggix post status changes for a Zapier trigger.

## `GET /triggers/post-status-changes`

Returns recent post status changes in the API key's workspace, newest first. The endpoint only checks changes created in the last 30 days.

### Query parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `limit` | integer | No | Maximum number of results, from 1 to 100. Defaults to 100 when omitted or invalid. |

### Request

```http theme={null}
GET https://www.suggix.com/v1/triggers/post-status-changes?limit=10
Authorization: Bearer sgx_api_your_key
```

### Successful response

`200 OK` returns an array of status change objects. An empty array means no matching changes were found in the lookback period.

```json theme={null}
[
  {
    "id": 2,
    "workspace_id": 7,
    "post_id": 367,
    "post": {
      "id": 367,
      "board_id": 10,
      "board_name": "Feature Request",
      "board_url": "feature-request",
      "title": "Add keyboard shortcuts",
      "url": "add-keyboard-shortcuts",
      "status_id": 7,
      "status_name": "Backlog"
    },
    "from_status_id": null,
    "from_status": null,
    "to_status_id": 7,
    "to_status": {
      "id": 7,
      "workspace_id": 7,
      "member_id": 14,
      "name": "Backlog",
      "type": 1,
      "sort": 0,
      "created_at": 1791609000000,
      "updated_at": 1791609000000
    },
    "changed_by": {
      "id": 14,
      "name": "Alex",
      "photo_url": "https://example.com/avatar.png",
      "email": "alex@example.com"
    },
    "created_at": 1791609328748
  }
]
```

### Response fields

| Field | Type | Description |
| - | - | - |
| `id`, `workspace_id`, `post_id` | integer | Change, workspace, and affected post identifiers. |
| `post` | object | Full post with board, creator, owner, status, counts, tags, and timestamps. Fields are the same as in the [New Posts trigger](/zapier/triggers-new-posts). |
| `from_status_id`, `to_status_id` | integer or `null` | Previous and new status identifiers. A missing previous status is `null`. |
| `from_status`, `to_status` | object or `null` | Previous and new status objects. A status contains `id`, `workspace_id`, `member_id`, `name`, `type`, `sort`, `created_at`, and `updated_at`. |
| `changed_by` | object or `null` | Actor with `id`, `name`, `photo_url`, and `email`. |
| `created_at` | integer | Change timestamp in Unix milliseconds. |

`status.type` values are `1` Backlog, `2` Planned, `3` In Progress, `4` Completed, and `5` Canceled. The internal `changed_by_id` is not returned separately; use `changed_by.id`.

### Errors

| HTTP status | Response | Cause |
| - | - | - |
| `401` | `{"error":"invalid or missing API key"}` | The API key is absent or invalid. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.