Skip to content
Console
On this page

Apply support decision on a support case

Atomically applies a typed decision, tracks and audit after checking expected_version.

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.

Atomically applies a typed decision, tracks and audit after checking expected_version. FINAL_NO_REPLY reopens to ACT_NOW only for an allowed trigger; spam requires a clearing verdict.

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/support-case:applySupportDecision
  • Scope notify:support:operate
  • 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
namestringCanonical resource name, checked against the caller grant. Required.
expected_versionint64Optimistic version precondition; mismatch returns ETAG_MISMATCH. Required.
request_idstringStable UUID for this logical operation.
validate_onlyboolValidate without changing state or contacting an effect provider.
beforeSupportCaseStateObserved primary state; also checked against authoritative storage. One of act_now, scheduled, waiting_customer, waiting_review, final_no_reply.
afterSupportDecisionComplete new decision; omitting an unresolved track is refused. Required.
spamSupportSpamDispositionSpam disposition; only authenticated verdicts clear suppression. One of suppressed, review_required, not_spam, confirmed_customer.
pending_proofSupportPendingProofSource proof for imported pending customer waits. One of last_outbound, staff_action, source_history.
source_keystringImmutable signal/decision identity for replay and audit.

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.

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
namestringThe canonical resource name.
uidstringImmutable platform identity. Output only.
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.
versionint64Aggregate version; every accepted decision increments it exactly once. Output only.
receive_timetimestampFirst source-reported received time, preserved through import. Required.
intake_timetimestampMost recent committed intake time; compared with the inbox intake bound. Output only.
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.

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.

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.

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.

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/support-case:applySupportDecision" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":{"explanation":"…","next_action_at":{},"owner":"…","policy_version":"…","reason":"policy","reopen_triggers":["new_evidence"],"settlement_buffer":{},"state":"act_now","time_zone":"…"},"expected_version":1}'