#DriftEvents

---

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

List drift events

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

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string

Query parameters

Name	Type	Description
status	open | accepted | reapplied | snoozed
kind	string	Filter by entity type name
entityName	string	Filter by entity name
since	string	ISO timestamp lower bound on detectedAt
before	string(date-time)	ISO timestamp upper bound on detectedAt
limit	integer	Maximum drift events to return
cursor	string	Keyset cursor from the previous page

Responses

Status	Description	Schema
200	OK	DriftEventPage
401	Unauthorized	Error
403	Forbidden	Error

---

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

Count open drift events

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string

Responses

Status	Description	Schema
200	OK	DriftCount
401	Unauthorized	Error
403	Forbidden	Error

---

#GET /{o}/{p}/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
id	string

Responses

Status	Description	Schema
200	OK	DriftEvent
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

---

#POST /{o}/{p}/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: drift:resolve

Path parameters

Name	Type	Description
o	string
p	string
id	string

Responses

Status	Description	Schema
200	OK	DriftEvent
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

---

#POST /{o}/{p}/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: drift:resolve

Path parameters

Name	Type	Description
o	string
p	string
id	string

Responses

Status	Description	Schema
200	OK	DriftReapplyResult
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

---

#POST /{o}/{p}/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: drift:resolve

Path parameters

Name	Type	Description
o	string
p	string
id	string

Request body (application/json)

Field	Type	Description
untilSeconds	integer

Responses

Status	Description	Schema
200	OK	DriftEvent
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

#Schemas

#DriftCount

Field	Type	Description
count	integer	(required)

#DriftEvent

Field	Type	Description
id	string(uuid)	(required)
projectId	string | null	(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)

#DriftEventPage

Field	Type	Description
items	DriftEvent[]	(required)
nextCursor	string | null	Cursor for the next page; null on the final page (required)

#DriftReapplyResult

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

#Error

Field	Type	Description
error	string	(required)
code	string