Atomicwork | Product

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:

FieldTypeDescription
attributestringThe field to filter on (see Supported attributes below)
operatorstringComparison operator (see Available operators below)
valuesarrayOne or more \{ "value": \<scalar> \} objects

Supported attributes

AttributeTypical operatorDescription
statusIS_ANY_OFChange status (e.g. DRAFT, IN_REVIEW, APPROVED, IMPLEMENTED).
typeIS_ANY_OFChange type.
assignee_idIS_ANY_OFAssigned agent user ID.
created_atIS_BETWEENCreation timestamp (ISO 8601).

Available operators

OperatorMeaning
EQUALSExact match
NOT_EQUALSExclude exact match
IN / IS_ANY_OFMatch any value in the list
IS_NOT_ANY_OFExclude all listed values
IS_BETWEENInclusive range — pass exactly two values: [start, end]
IS_ON_OR_BEFORE / IS_ON_OR_AFTERDate/time boundary comparisons
CONTAINS / TEXT_CONTAINSSubstring or set membership
IS_NULL / IS_NOT_NULLNull checks — values array can be empty
STARTS_WITH / ENDS_WITHString prefix/suffix match

Example

[
  {
    "attribute": "status",
    "operator": "IS_ANY_OF",
    "values": [
      {
        "value": "DRAFT"
      },
      {
        "value": "IN_REVIEW"
      }
    ]
  },
  {
    "attribute": "created_at",
    "operator": "IS_BETWEEN",
    "values": [
      {
        "value": "2024-01-01T00:00:00Z"
      },
      {
        "value": "2024-12-31T23:59:59Z"
      }
    ]
  }
]

Authorization

X-Api-Keyheaderstringrequired

API key authentication.

Headers

X-Workspace-Idheaderstring

Path Parameters

workspace_idpathintegerrequired

Workspace ID (numeric). Find yours under Settings → Workspace.

Query Parameters

filter_namequerystringrequired
sort_orderqueryenum (string)
Allowed valuesCREATED_AT_DESCCREATED_AT_ASCUPDATED_AT_DESC
sortquerystring

Comma-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.

pagequeryintegerrequired
per_pagequeryinteger
paginatequeryboolean

Response

200

Successful response