Skip to main content
POST
Create Reconciliation Finding

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Api-key
string | null

Body

application/json
asset_type
enum<string>
required
Available options:
automation,
dashboard,
dataset,
deployment,
feature,
model,
ontology,
pipeline,
strategy
asset_id
string
required
Required string length: 1 - 255
finding_type
enum<string>
required
Available options:
missing_link,
stale_link,
missing_definition,
schema_drift,
definition_conflict,
memory_change_requires_review,
asset_deleted,
proposed_update
title
string
required
Required string length: 1 - 255
asset_name
string | null
Maximum string length: 255
memory_type
enum<string> | null
Available options:
feature,
ontology,
strategy
memory_key
string | null
Maximum string length: 255
severity
enum<string>
default:medium
Available options:
info,
low,
medium,
high,
critical
status
enum<string>
default:open
Available options:
open,
proposed,
approved,
rejected,
resolved,
dismissed
source
enum<string>
default:agent
Available options:
agent,
backend_hook,
human,
system_job
confidence
number | null
Required range: 0 <= x <= 1
description
string | null
Maximum string length: 4000
observed_state
Observed State · object
documented_state
Documented State · object
proposed_action
Proposed Action · object
fingerprint
string | null
Maximum string length: 500
assigned_to_member_id
string<uuid> | null
review_context
string | null

Optional reviewer-facing ticket context from the originating agent or workflow. This is used for governance notifications and is not stored on the finding itself.

Maximum string length: 1500

Response

Successful Response

asset_type
enum<string>
required
Available options:
automation,
dashboard,
dataset,
deployment,
feature,
model,
ontology,
pipeline,
strategy
asset_id
string
required
Required string length: 1 - 255
finding_type
enum<string>
required
Available options:
missing_link,
stale_link,
missing_definition,
schema_drift,
definition_conflict,
memory_change_requires_review,
asset_deleted,
proposed_update
title
string
required
Required string length: 1 - 255
id
string<uuid>
required
organisation_id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
asset_name
string | null
Maximum string length: 255
memory_type
enum<string> | null
Available options:
feature,
ontology,
strategy
memory_key
string | null
Maximum string length: 255
severity
enum<string>
default:medium
Available options:
info,
low,
medium,
high,
critical
status
enum<string>
default:open
Available options:
open,
proposed,
approved,
rejected,
resolved,
dismissed
source
enum<string>
default:agent
Available options:
agent,
backend_hook,
human,
system_job
confidence
number | null
Required range: 0 <= x <= 1
description
string | null
Maximum string length: 4000
observed_state
Observed State · object
documented_state
Documented State · object
proposed_action
Proposed Action · object
fingerprint
string | null
Maximum string length: 500
review_context
string | null
assigned_to_member_id
string<uuid> | null
created_by_member_id
string<uuid> | null
reviewed_by_member_id
string<uuid> | null
resolved_by_member_id
string<uuid> | null
review_notes
string | null
resolution_notes
string | null
reviewed_at
string<date-time> | null
resolved_at
string<date-time> | null