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.comdoes 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
| Field | Type | What it is |
|---|---|---|
name | string | The canonical resource name. |
uid | string | Immutable platform identity. Output only. |
meta | ResourceMeta | Strong ETag and common metadata. |
inbox | string | The queue owning this case. Required. |
display_number | string | Original customer-visible case number, including legacy CS numbers. |
subject | string | Case subject; untrusted customer content. Never returned again. |
requester | SupportRequester | Masked case-scoped requester snapshot; Knowledge owns mutable contacts. Required. |
tenant_subject | string | Tenant product/account reference. It conveys no verified account ownership. Never returned again. |
decision | SupportDecision | Current primary decision, including the required owner and next action. Required. |
version | int64 | Aggregate version; every accepted decision increments it exactly once. Output only. |
receive_time | timestamp | First source-reported received time, preserved through import. Required. |
intake_time | timestamp | Most recent committed intake time; compared with the inbox intake bound. Output only. |
source_records | SupportSourceRecord[] | Exact source identities and protected full-record evidence references. |
source_state | string | Raw source state/priority/category are preserved rather than collapsed. |
priority | string | Case-level priority is separate from state and issue classification. |
last_inbound_time | timestamp | Last inbound activity, if known. |
last_outbound_time | timestamp | Last confirmed outbound activity, if known. |
last_activity_time | timestamp | Last activity, including internal notes. |
resolve_time | timestamp | Original resolution time, if known; FINAL_NO_REPLY is still ingestible. |
evidence | SupportEvidence[] | Source evidence, including admission-refused/automated records when linked. |
spam | SupportSpamDisposition | Spam suppression survives incoming evidence/payment/notices until a verdict. One of suppressed, review_required, not_spam, confirmed_customer. |
pending_proof | SupportPendingProof | Required 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.
| Method | Call | What it does |
|---|---|---|
GET | get | Gets one SupportCase; protected identities require a separately audited reveal. |
GET | list | Lists scoped support_cases; no cross-tenant or internal-message projection. |
POST | create | Creates an idempotent SupportCase; changed replay and illegal state are refused. |
POST | 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 | 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 | reveal_support_requester | Reveals the protected case requester under a purpose-bound grant and appends an audited read. |
POST | 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. |
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