Skip to content
Console
On this page

Support cases

A SupportCase has one primary state and independently linked issue/action tracks.

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.

A SupportCase has one primary state and independently linked issue/action tracks. The case aggregate version serializes decisions across all tracks. No API or resource name contains a deployment, database or provider address.

Service Sylphx Notify · Resource type notify.sylphx.com/SupportCase · Name pattern orgs/{org}/projects/{project}/envs/{env}/support_cases/{support_case} · Shape record

Fields

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.

Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

MethodCallWhat it does
GETgetGets one SupportCase; protected identities require a separately audited reveal.
GETlistLists scoped support_cases; no cross-tenant or internal-message projection.
POSTcreateCreates an idempotent SupportCase; changed replay and illegal state are refused.
POSTapply_support_decisionAtomically 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.
POSTingest_support_signalAdmits one authenticated source signal, deduped by immutable identity. Spam signals wake reclassification review without reopening, customer reply or new business action.
POSTreveal_support_requesterReveals the protected case requester under a purpose-bound grant and appends an audited read.
POSTimportImports 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.

get

Gets one SupportCase; protected identities require a separately audited reveal.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case · scope notify:support:read · effect read · not available yet · Request, response and examples

list

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

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases · scope notify:support:read · effect read · not available yet · paginated · Request, response and examples

create

Creates an idempotent SupportCase; changed replay and illegal state are refused.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases · scope notify:support:operate · effect write · not available yet · validate_only · Request, response and examples

apply_support_decision

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.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case:applySupportDecision · scope notify:support:operate · effect write · not available yet · validate_only · Request, response and examples

ingest_support_signal

Admits one authenticated source signal, deduped by immutable identity. Spam signals wake reclassification review without reopening, customer reply or new business action.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case:ingestSupportSignal · scope notify:support:ingest · effect write · not available yet · validate_only · Request, response and examples

reveal_support_requester

Reveals the protected case requester under a purpose-bound grant and appends an audited read.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case:revealSupportRequester · scope notify:support:reveal · effect write · not available yet · validate_only · Request, response and examples

import

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.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases:import · scope notify:support:import · effect write · not available yet · validate_only · Request, response and examples