@celigo/api-specs 0.2.79 → 0.2.80

package/dist/agent.yml

@@ -600,6 +600,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/ai-agent.yml

@@ -5425,6 +5425,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/api.yml

@@ -4637,6 +4637,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/asynchelper.yml

@@ -3154,6 +3154,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/connection.yml

@@ -3244,6 +3244,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/connector.yml

@@ -1103,6 +1103,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/ediprofile.yml

@@ -656,6 +656,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/enduser.yml

@@ -1883,6 +1883,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/environment.yml

@@ -393,6 +393,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/eventreport.yml

@@ -351,6 +351,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/export.yml

@@ -16787,6 +16787,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/filedefinition.yml

@@ -1173,6 +1173,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/flow.yml

@@ -5609,6 +5609,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/guardrail.yml

@@ -463,6 +463,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/httpconnector.yml

@@ -1850,6 +1850,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/httpconnectorendpoint.yml

@@ -932,6 +932,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/iclient.yml

@@ -4244,6 +4244,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/import.yml

@@ -16261,6 +16261,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/integration.yml

@@ -3531,9 +3531,21 @@ components:
           examples:
             - 1.2.0
           description: |-
-            Integration App version (or template version) associated with this integration.
-
-            Usually system-managed for Integration App installs; omit unless you are explicitly controlling versions.
+            Version of the Integration App (or template) currently installed in this integration.
+            For Integration Apps the connector's update workflow sets it; omit unless you are
+            explicitly controlling versions.
+          x-celigo-ai-guidance:
+            - |-
+              This is the installed version only. No API field carries an Integration App's newest
+              available version (the connector record has none), so whether a newer release exists
+              cannot be read from the platform — say so rather than inferring it from release notes,
+              which are labeled by their own scheme, not by this value.
+            - |-
+              To date an Integration App update, read the integration's audit log
+              (`GET /v1/integrations/{_id}/audit?source=connector`) for `version` field changes —
+              one entry per version step, and an update run usually writes several in a row.
+              `lastModified` moves on any write and `updateInProgress` can flip without a version
+              change, so neither dates an update.
         tag:
           type:
             - string
@@ -3551,6 +3563,9 @@ components:
             API, but normally managed by the platform's update workflow.
           x-celigo-ai-guidance:
             - Typically system-managed; omit unless a workflow explicitly requires setting it.
+            - |-
+              An update run can set and clear it without changing `version`; its audit entries alone
+              do not mean a new release was installed — the `version` changes do.
         celigoAgentAutoRunMode:
           type: boolean
           examples:
@@ -3569,6 +3584,10 @@ components:
             Timestamp indicating when the most recent install/update workflow was resolved/completed.
 
             Typically system-managed; omit in normal create/update payloads.
+          x-celigo-ai-guidance:
+            - |-
+              May be absent on an installed Integration App even after its update workflow has run —
+              date an update from the audit log's `version` changes, not from this field.
         settingsForm:
           description: Settings form definition for the integration.
           allOf:
@@ -4279,6 +4298,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/job.yml

@@ -1189,6 +1189,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/lookupcache.yml

@@ -758,6 +758,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/mcp-oauth-provider.yml

@@ -422,6 +422,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/mcp-server.yml

@@ -3315,6 +3315,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/notification.yml

@@ -244,6 +244,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/tag.yml

@@ -336,6 +336,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/template.yml

@@ -643,6 +643,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/tool.yml

@@ -6273,6 +6273,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/tradingpartnerconnector.yml

@@ -1307,6 +1307,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/dist/user.yml

@@ -737,6 +737,14 @@ components:
           description: Timestamp when the resource was last updated. Changes whenever any property is modified.
           x-celigo-ai-guidance:
             - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+            - |-
+              Records that something was written, not what — a settings edit, a flag flip, or a
+              platform workflow all move it. What changed and when is in the audit log: the
+              per-resource route `GET /v1/{resourceType}/{_id}/audit` for the types its
+              `resourceType` enum lists, or the account-wide
+              `GET /v1/audit?resourceType=<singular>&_resourceId={_id}` for the further types that
+              endpoint's enum accepts (users, environments, notifications among them). A type absent
+              from both enums — jobs, connectors, templates — has only this timestamp.
           examples:
             - '2023-04-15T14:30:15Z'
         deletedAt:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.79",
+  "version": "0.2.80",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [

package/schemas.json

@@ -1,7 +1,7 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "8b3a38c",
+		"iasCommit": "09c1f65",
 		"generatedAt": "2026-10-08"
 	},
 	"roots": {