#DriftEvents

---

#GET /{o}/{p}/envs/{envName}/drift-events

List drift events

List drift events in this environment with optional status/kind/entity/time filtering.

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string
envName	string

Responses

Status	Description	Schema
200	Drift events	DriftEventList

---

#GET /{o}/{p}/envs/{envName}/drift-events/count

Count open drift events

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string
envName	string

Responses

Status	Description	Schema
200	Open drift-event count	DriftCount

---

#GET /{o}/{p}/envs/{envName}/drift-events/{id}

Get a drift event by id

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string
envName	string
id	string

Responses

Status	Description	Schema
200	The drift event	DriftEvent
404	Drift event not found	Error

---

#POST /{o}/{p}/envs/{envName}/drift-events/{id}/accept

Accept a drift event

Promote the observed (actual) value into the catalog for the drifted field. Never touches real infrastructure.

Auth: Bearer token required · Permission: data:write

Path parameters

Name	Type	Description
o	string
p	string
envName	string
id	string

Responses

Status	Description	Schema
200	Accepted drift event	DriftEvent
404	Open drift event not found	Error

---

#POST /{o}/{p}/envs/{envName}/drift-events/{id}/reapply

Mark a drift event for re-apply

Record intent to push the catalog value back to actual. The actual reapply flows through the apply pipeline; this only records intent.

Auth: Bearer token required · Permission: data:write

Path parameters

Name	Type	Description
o	string
p	string
envName	string
id	string

Responses

Status	Description	Schema
200	Reapply intent recorded	DriftReapplyResult
404	Open drift event not found	Error

---

#POST /{o}/{p}/envs/{envName}/drift-events/{id}/snooze

Snooze a drift event

Snooze the drift event for untilSeconds (default 1 day, capped at 30 days).

Auth: Bearer token required · Permission: data:write

Path parameters

Name	Type	Description
o	string
p	string
envName	string
id	string

Request body (application/json)

Field	Type	Description
untilSeconds	integer

Responses

Status	Description	Schema
200	Snoozed drift event	DriftEvent
404	Open drift event not found	Error

#Schemas

#DriftCount

Field	Type	Description
count	integer	(required)

#DriftEvent

Field	Type	Description
id	string(uuid)	(required)
projectId	string,null	(required)
envId	string(uuid)	(required)
entityId	string(uuid)	(required)
entityName	string,null	(required)
entityTypeName	string,null	(required)
fieldPath	string	(required)
catalogValue	object
actualValue	object
source	string	(required)
status	open | accepted | reapplied | snoozed	(required)
snoozedUntil	string,null	(required)
detectedAt	string	(required)
updatedAt	string	(required)

#DriftEventList

Type: DriftEvent[]

#DriftReapplyResult

Field	Type	Description
driftEvent	DriftEvent	(required)
entity	object,null	(required)

#Error

Field	Type	Description
error	string	(required)
code	string