Skip to content
Console
On this page

List support reconciliations

Lists scoped support_reconciliations; no cross-tenant or internal-message projection.

This method is not served on the public API. api.sylphx.com does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

Lists scoped support_reconciliations; no cross-tenant or internal-message projection.

Not available yet. This method answers 501 with the problem code UNIMPLEMENTED.

  • Path GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_reconciliations
  • Scope notify:support:read
  • Effect read — nothing is written.
  • Collection support_reconciliations
  • Query page_size, page_token, filter, order_by
  • Pagination the answer carries support_reconciliations and, when there is more, next_page_token

Request

FieldTypeWhat it is
parentstringAuthenticated parent scope. Required.
page_sizeint32Maximum rows; default 50, at most 200.
page_tokenstringOpaque continuation bound to the same scope and filter.
filterstringAIP-160 filter; cannot widen caller visibility.
order_bystringStable ordering, with resource identity as the final tie-breaker.

Response

FieldTypeWhat it is
support_reconciliationsSupportReconciliation[]Visible records only.
next_page_tokenstringContinuation; empty only after the final page.

SupportReconciliation

FieldTypeWhat it is
namestringCanonical report name.
uidstringImmutable identity. Output only.
metaResourceMetaPublication timestamps.
kindSupportReconciliationKindFull daily population or earliest-deadline-aligned due population. One of full_daily, due_scan, migration_compare.
inboxstringExact queue/scope covered; never a cross-tenant scan bypass.
actorSupportActorVerified principal/workload that requested the pass.
snapshot_timetimestampSnapshot/read time and source watermark used to establish coverage.
source_watermarkstringAuthoritative source cursor or snapshot token, not a secret.
completeboolTrue only when every page in the declared population was checked.
checked_casesint64Number of cases checked; zero proves nothing without complete coverage.
unownedint64Cases without an accountable owner.
unscheduledint64Cases without a required next action.
overdueint64Unhandled due obligations or next actions.
exceptionsSupportReconciliationException[]Every exception is retained, not only a count or a truncated sample.
next_scan_timetimestampNext on-demand scan, no later than the earliest unhandled obligation/action.
population_sha256stringFull canonical population hash for migration/read-compare, when applicable.

ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

SupportActor

FieldTypeWhat it is
principalstringActing Access principal or authenticated external source identity. Required.
delegated_forstringDelegating principal, when the grant records one.
authoritystringPublic source authority for a workload or channel event.

SupportReconciliationException

FieldTypeWhat it is
resourcestringAffected case/action/source resource, scoped by the authenticated query.
kindstringunowned, unscheduled, overdue, uncertain_action, intake_late or source_mismatch.
reasonstringActionable explanation with no unrestricted customer content.
due_timetimestampEarliest related missed action or obligation, when applicable.

Errors

  • UNAUTHENTICATED — No valid key or token was presented.
  • PERMISSION_DENIED — The key lacks the method's permission.
  • INVALID_FIELD — A field failed validation.
  • RESOURCE_NOT_FOUND — The named Resource does not exist or is not visible.
  • ETAG_MISMATCH — The etag sent does not match the Resource's current etag.
  • INVALID_STATE — The Resource is in a state that forbids the call.
  • UNAVAILABLE — The Resource store, the owning service's backend, or the key verifier's snapshot is unavailable; retry after Retry-After.
  • UNIMPLEMENTED — The path or method is not served (yet) at this version.

Every error arrives in the body Errors describes.

Examples

curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_reconciliations" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"