Skip to content
Console
On this page

Import a support case

Imports inert history with unchanged source IDs/keys/tombstones, full-record hashes and explicit migration exceptions.

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.

Imports inert history with unchanged source IDs/keys/tombstones, full-record hashes and explicit migration exceptions. It sends nothing, runs no agent and meters no resolution.

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

  • Path POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases:import
  • Scope notify:support:import
  • Effect write — a successful call changes state.
  • Collection support_cases
  • Validate-only validate_only=true runs every check and writes nothing

Request

FieldTypeWhat it is
parentstringAuthenticated destination environment. Required.
sourcestringStable source namespace and migration run identity.
support_casesSupportCase[]Original case records and typed projections; at most 500.
messagesSupportThreadMessage[]Original thread records, including internal messages and erasure tombstones.
actionsSupportAction[]Original actions/keys/receipts; ambiguous prior sends remain UNCERTAIN. Suppression never blocks inert CANCELLED/SUCCEEDED/UNCERTAIN history; import admits no PENDING/IN_FLIGHT action under suppression and sends nothing.
audit_eventsSupportAuditEvent[]Original audit records; absent historical versions are not invented.
source_sha256stringFull source-record hash of this batch; changed replay is refused.
request_idstringStable UUID for this batch.
validate_onlyboolValidate and compare without writing.

SupportCase

FieldTypeWhat it is
namestringThe canonical resource name.
metaResourceMetaStrong ETag and common metadata.
inboxstringThe queue owning this case. Required.
display_numberstringOriginal customer-visible case number, including legacy CS numbers.
subjectstringCase subject; untrusted customer content. Never returned again.
requesterSupportRequesterMasked case-scoped requester snapshot; Knowledge owns mutable contacts. Required.
tenant_subjectstringTenant product/account reference. It conveys no verified account ownership. Never returned again.
decisionSupportDecisionCurrent primary decision, including the required owner and next action. Required.
receive_timetimestampFirst source-reported received time, preserved through import. Required.
source_recordsSupportSourceRecord[]Exact source identities and protected full-record evidence references.
source_statestringRaw source state/priority/category are preserved rather than collapsed.
prioritystringCase-level priority is separate from state and issue classification.
last_inbound_timetimestampLast inbound activity, if known.
last_outbound_timetimestampLast confirmed outbound activity, if known.
last_activity_timetimestampLast activity, including internal notes.
resolve_timetimestampOriginal resolution time, if known; FINAL_NO_REPLY is still ingestible.
evidenceSupportEvidence[]Source evidence, including admission-refused/automated records when linked.
spamSupportSpamDispositionSpam suppression survives incoming evidence/payment/notices until a verdict. One of suppressed, review_required, not_spam, confirmed_customer.
pending_proofSupportPendingProofRequired migration proof before legacy pending may mean WAITING_CUSTOMER. One of last_outbound, staff_action, source_history.

SupportThreadMessage

FieldTypeWhat it is
namestringCanonical thread message name.
metaResourceMetaTimestamps and metadata.
source_keystringImmutable source-scoped event identity; changed replays are refused. Required.
visibilitySupportMessageVisibilityExplicit audience; internal notes never enter the customer timeline. Required. One of public, internal.
authorSupportActorVerified author; never inferred from a claimed From address.
bodystringText body or evidence projection; untrusted personal content. Never returned again.
evidenceSupportEvidence[]Source evidence, including explicitly untrusted HTML and attachments.
channel_idstringExisting channel-link ID, not a credential.
thread_keysstring[]Original provider message identity and ancestry.
actionstringRelated business action, never a notification delivery state alias.
erasedboolTombstone; source keys/ancestry survive authorized erasure.
source_recordsSupportSourceRecord[]Original IDs/records for lossless migration.
directionstringSource direction: inbound, outbound or internal; independent of visibility.

SupportAction

FieldTypeWhat it is
namestringCanonical action name.
metaResourceMetaStrong ETag and creation/update times.
idempotency_keystringExact stable caller/source key; never replaced on retry or cutover.
payload_sha256stringSHA-256 of immutable admitted intent bytes; changed-key reuse is refused.
track_idstringRelated action/issue track in the same case.
replySupportChannelReplyReply using an existing channel authority. One of the intent group.
remedySupportRemedyRequestRequest the tenant's own remedy API; Support never writes product data. One of the intent group.
escalationSupportEscalationNotify an accountable reviewer through an existing API. One of the intent group.
source_recordsSupportSourceRecord[]Source outbox ID/key/payload/leases/attempts retained as protected evidence.

SupportAuditEvent

FieldTypeWhat it is
namestringCanonical audit name.
metaResourceMetaCommitted timestamps.
actorSupportActorVerified actor/decider for this event.
beforeSupportDecisionPrevious complete primary decision, including tracks and deadlines.
afterSupportDecisionNew complete primary decision.
before_versionint64Previous aggregate version, checked before applying the event.
versionint64New aggregate version; exactly before_version + 1 for a transition.
source_keystringSource event key; repeated delivery cannot create another transition.
overdueSupportOverdueTyped overdue fact, when this is a due-scan event instead of a transition.
source_recordsSupportSourceRecord[]Protected original historical event, when importing old audit without versions.

ResourceMeta

FieldTypeWhat it is
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.

SupportRequester

FieldTypeWhat it is
contactstringPermission-scoped Knowledge contact resource, when available.
masked_identitystringMasked contact address or channel identity for ordinary case reads.
display_namestringSource display name; treated as personal data. Never returned again.
link_statestringnone, suggested, confirmed or cleared; an unconfirmed link grants nothing.
tenant_subjectstringTenant-owned subject mapping, not a Support-issued user identity. Never returned again.
link_actorSupportActorWho verified or cleared the link, if known.
link_timetimestampWhen the source link was verified or cleared, if known.
source_recordsSupportSourceRecord[]Original requester identity and source record, including tombstones.

SupportDecision

FieldTypeWhat it is
stateSupportCaseStateExactly one primary state. Required. One of act_now, scheduled, waiting_customer, waiting_review, final_no_reply.
ownerstringAccountable Access principal; required even while waiting or final. Required.
reasonSupportDecisionReasonTyped cause of this decision or reopen. Required. One of policy, operator, new_evidence, new_payment, legal_notice, regulatory_notice, due, migration, spam_reclassification, not_spam, confirmed_customer, institutional_notice.
explanationstringCustomer-safe explanation; no credentials or unrestricted product records. Required.
next_action_attimestampRequired for every state, including FINAL_NO_REPLY. Never a delivery retry. Required.
deadlinesSupportDeadline[]May be empty when no hard deadline applies; each entry keeps its basis.
tracksSupportTrack[]Independent linked issues and actions; mixed cases cannot drop an issue.
reopen_triggersSupportReopenTrigger[]Required triggers. On spam they request reclassification review only; no customer-facing reopen or outbound action occurs before a clearing verdict. Required. One of new_evidence, new_payment, legal_notice, regulatory_notice.
policy_versionstringImmutable tenant-policy API resource and version that produced the decision. Required.
time_zonestringIANA tenant time zone used for business-hours/deadline arithmetic. Required.
settlement_bufferdurationNonnegative settlement buffer used in that calculation. Required.
evidence_idsstring[]Evidence IDs used by the decider, never evidence invented by a model.

SupportSourceRecord

FieldTypeWhat it is
sourcestringStable source namespace, retained across retries and migration phases.
source_tablestringOriginal relation or event kind.
source_idstringUnchanged source primary key, including numeric case/message/outbox IDs.
evidenceSupportEvidenceEvidence holding the full canonical source record, not a lossy projection.
source_versionint64Original source version, if present; zero means absent, not fabricated.

SupportEvidence

FieldTypeWhat it is
idstringStable evidence identity in the tenant environment.
authoritystringAuthenticated source, not a caller-selected trust claim.
resourcestringPermissioned public API resource containing the bytes; never a credential URL.
sha256stringSHA-256 of the original evidence bytes, lowercase hexadecimal.
media_typestringRegistered media type of the original bytes.
size_bytesint64Exact byte length, not the number of Unicode characters.
receive_timetimestampSource-reported received time.
erasedboolErasure keeps identity/hash/dedupe tombstones, never resurrects source content.

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.

SupportChannelReply

FieldTypeWhat it is
transportstringPermissioned channel resource; deployment and provider host are irrelevant.
recipientstringChannel-scoped recipient/conversation identity, not verified tenant identity. Never returned again.
bodystringPublic reply body; legal/permission checks precede action admission. Never returned again.
subjectstringThreading subject, when the channel has one. Never returned again.
local_message_idstringExact original local message identity and provider ancestry.
in_reply_tostringNearest parent provider message identity.
referencesstring[]Original ancestry in order.

SupportRemedyRequest

FieldTypeWhat it is
operationstringPublished tenant operation resource or API endpoint, under the caller grant.
requestSupportEvidenceContent-addressed, permissioned request evidence; contains no credentials.
authorization_receiptstringTenant authorization/verification receipt binding exact remedy arguments.

SupportEscalation

FieldTypeWhat it is
reviewerstringAccountable principal or reviewer group.
destinationstringPermissioned destination API resource.
briefstringReview brief; internal, never a customer message. Never returned again.

SupportOverdue

FieldTypeWhat it is
kindstringnext_action, track_next_action or deadline; exact target ID accompanies it.
target_idstringDeadline/track identity, or empty for the primary next action.
due_timetimestampTime that was missed, never silently advanced by the scan.
detect_timetimestampWhen the miss was detected.

SupportDeadline

FieldTypeWhat it is
idstringImmutable obligation identity within the case. Required.
kindSupportDeadlineKindLegal, platform, contract or internal obligation. Required. One of legal, platform, contract, internal.
jurisdictionstringApplicable jurisdiction, or an explicit internal/platform scope. Required.
basisstringExact rule, law, platform term or contract establishing the deadline. Required.
due_timetimestampAbsolute computed deadline; never extended by transport retry. Required.
track_idstringRelated issue/action track; empty for a case-wide obligation.

SupportTrack

FieldTypeWhat it is
idstringImmutable identity within the case. Required.
kindSupportTrackKindISSUE or ACTION; never a competing case/thread identity. Required. One of issue, action.
categorystringTenant's issue category, for example payment, privacy or technical. Required.
stateSupportCaseStateIndependent track state; primary state cannot hide outstanding tracks. Required. One of act_now, scheduled, waiting_customer, waiting_review, final_no_reply.
ownerstringAccountable principal for this track. Required.
next_action_attimestampRequired follow-up for this track. Required.
linked_track_idsstring[]Other track IDs in the same case; no cross-tenant links.
actionstringAction resource associated with an action track, when admitted.
evidence_idsstring[]Evidence IDs relevant to this issue, not all case personal data.
reasonstringClassification reason for this track. Required.

Response

FieldTypeWhat it is
sourcestringSource namespace echoed for verification.
importedint64Inserted records, counted across every supplied kind.
replayedint64Exact unchanged replays; no duplicate effect is created.
target_sha256stringFull canonical destination batch hash.
exceptionsSupportReconciliationException[]Every missing classification/proof/source mismatch, not a truncated sample.

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

Every error arrives in the body Errors describes.

Examples

curl -X POST "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases:import" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'