Change Management
Get changes by filter
POST https://{tenant}.atomicwork.com/api/v1/workspaces/{workspace_id}/change-management/changes/list
Filtering
The request body is an array of filter objects. Send an empty array ([]) to retrieve all records.
Each filter object has the following fields:
| Field | Type | Description |
|---|---|---|
attribute | string | The field to filter on (see Supported attributes below) |
operator | string | Comparison operator (see Available operators below) |
values | array | One or more \{ "value": \<scalar> \} objects |
Supported attributes
| Attribute | Typical operator | Description |
|---|---|---|
status | IS_ANY_OF | Change status (e.g. DRAFT, IN_REVIEW, APPROVED, IMPLEMENTED). |
type | IS_ANY_OF | Change type. |
assignee_id | IS_ANY_OF | Assigned agent user ID. |
created_at | IS_BETWEEN | Creation timestamp (ISO 8601). |
Available operators
| Operator | Meaning |
|---|---|
EQUALS | Exact match |
NOT_EQUALS | Exclude exact match |
IN / IS_ANY_OF | Match any value in the list |
IS_NOT_ANY_OF | Exclude all listed values |
IS_BETWEEN | Inclusive range — pass exactly two values: [start, end] |
IS_ON_OR_BEFORE / IS_ON_OR_AFTER | Date/time boundary comparisons |
CONTAINS / TEXT_CONTAINS | Substring or set membership |
IS_NULL / IS_NOT_NULL | Null checks — values array can be empty |
|
Example
[
{
"attribute": "status",
"operator": "IS_ANY_OF",
"values": [
{
"value": "DRAFT"
},
{
"value": "IN_REVIEW"
}
]
},
{
"attribute": "created_at",
"operator": "IS_BETWEEN",
"values": [
{
"value"
Authorization
X-Api-KeyrequiredAPI key authentication.
Headers
X-Workspace-IdPath Parameters
workspace_idrequiredWorkspace ID (numeric). Find yours under Settings → Workspace.
Query Parameters
filter_namerequiredsort_orderAllowed values
CREATED_AT_DESCCREATED_AT_ASCUPDATED_AT_DESCsortComma-separated sort keys as field:direction (e.g. status:asc,created_at:desc), up to 2 keys. Field keys come from GET /views/CHANGE/fields (entries with sortable: true). Takes precedence over sort_order. Invalid/unknown fields -> 400.
pagerequiredper_pagepaginateResponse
Successful response