---
# @generated by sylphx-gen. Do not edit.
title: "Support cases"
description: "The `support_cases` collection of Sylphx Notify: A SupportCase has one primary state and independently linked issue/action tracks."
type: reference
product: support
summary: "A SupportCase has one primary state and independently linked issue/action tracks."
updated: 2026-09-28
order: 900
---

> **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

| 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`](/docs/api/support_cases#get) | Gets one SupportCase; protected identities require a separately audited reveal. |
| `GET` | [`list`](/docs/api/support_cases#list) | Lists scoped support_cases; no cross-tenant or internal-message projection. |
| `POST` | [`create`](/docs/api/support_cases#create) | Creates an idempotent SupportCase; changed replay and illegal state are refused. |
| `POST` | [`apply_support_decision`](/docs/api/support_cases#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`](/docs/api/support_cases#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`](/docs/api/support_cases#reveal-support-requester) | Reveals the protected case requester under a purpose-bound grant and appends an audited read. |
| `POST` | [`import`](/docs/api/support_cases#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](/docs/api/support_cases/get)

## 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](/docs/api/support_cases/list)

## 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](/docs/api/support_cases/create)

## 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](/docs/api/support_cases/apply_support_decision)

## 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](/docs/api/support_cases/ingest_support_signal)

## 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](/docs/api/support_cases/reveal_support_requester)

## 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](/docs/api/support_cases/import)
