---
# @generated by sylphx-gen. Do not edit.
title: "Support actions"
description: "The `support_actions` collection of Sylphx Notify: SupportAction is the case's business intent ledger, NOT an email outbox or notify_deliveries row."
type: reference
product: support
summary: "SupportAction is the case's business intent ledger, NOT an email outbox or notify_deliveries row."
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.

SupportAction is the case's business intent ledger, NOT an email outbox or notify_deliveries row. Transport changes never mutate this record implicitly. Stable keys and payload hashes survive all attempts, uncertain outcomes and migration. Exactly-once visible results require duplicate-safe transport AND authoritative provider/tenant reconciliation, not exactly-once HTTP delivery.

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

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | Canonical action name. |
| `uid` | `string` | Immutable identity. Output only. |
| `meta` | `ResourceMeta` | Strong ETag and creation/update times. |
| `idempotency_key` | `string` | Exact stable caller/source key; never replaced on retry or cutover. |
| `payload_sha256` | `string` | SHA-256 of immutable admitted intent bytes; changed-key reuse is refused. |
| `track_id` | `string` | Related action/issue track in the same case. |
| `state` | `SupportActionState` | Business state, independently versioned from the transport. Output only. One of `pending`, `in_flight`, `uncertain`, `succeeded`, `failed`, `cancelled`. |
| `version` | `int64` | Optimistic concurrency version of the business action. Output only. |
| `actor` | `SupportActor` | Authenticated creator or admitting workload. Output only. |
| `reply` | `SupportChannelReply` | Reply using an existing channel authority. One of the `intent` group. |
| `remedy` | `SupportRemedyRequest` | Request the tenant's own remedy API; Support never writes product data. One of the `intent` group. |
| `escalation` | `SupportEscalation` | Notify an accountable reviewer through an existing API. One of the `intent` group. |
| `receipt` | `SupportActionReceipt` | Latest authoritative receipt; dispatch/admission alone is not completion. Output only. |
| `failure_cause` | `string` | Cause and unknown effect are separate facts. Output only. |
| `reconcile_time` | `timestamp` | Next permitted reconciliation/query time; UNKNOWN never means resend. Output only. |
| `source_records` | `SupportSourceRecord[]` | Source outbox ID/key/payload/leases/attempts retained as protected evidence. |
| `attempt_count` | `int32` | Current dispatch attempt number; advances only on a new fenced claim. Output only. |
| `uncertainty_episode` | `int64` | Storage-owned monotonic generation, incremented on each entry to UNCERTAIN. A reconciliation receipt must resolve this exact episode and attempt. Output only. |

## 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_actions#get) | Gets one SupportAction; protected identities require a separately audited reveal. |
| `GET` | [`list`](/docs/api/support_actions#list) | Lists scoped support_actions; no cross-tenant or internal-message projection. |
| `POST` | [`create`](/docs/api/support_actions#create) | Creates an idempotent SupportAction; changed replay and illegal state are refused. |
| `POST` | [`begin_support_action_attempt`](/docs/api/support_actions#begin-support-action-attempt) | Claims one fenced attempt of a conclusively dispatchable action. An expired in-flight claim becomes UNCERTAIN, never PENDING. |
| `POST` | [`record_support_action_receipt`](/docs/api/support_actions#record-support-action-receipt) | Records an authenticated immutable authority receipt. Transport state changes alone never change a case or business action. |
| `POST` | [`reconcile`](/docs/api/support_actions#reconcile) | Queries the original authority/key first; UNKNOWN remains UNCERTAIN. Only a verified NOT_APPLIED query receipt for the current attempt and uncertainty episode permits another attempt of the same action/key. |

## get

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

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_actions/support-action` · scope `notify:support:read` · effect `read` · not available yet · [Request, response and examples](/docs/api/support_actions/get)

## list

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

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_actions` · scope `notify:support:read` · effect `read` · not available yet · paginated · [Request, response and examples](/docs/api/support_actions/list)

## create

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

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_actions` · scope `notify:support:actions` · effect `write` · not available yet · validate_only · [Request, response and examples](/docs/api/support_actions/create)

## begin_support_action_attempt

Claims one fenced attempt of a conclusively dispatchable action. An expired in-flight claim becomes UNCERTAIN, never PENDING.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_actions/support-action:beginSupportActionAttempt` · scope `notify:support:dispatch` · effect `write` · not available yet · validate_only · [Request, response and examples](/docs/api/support_actions/begin_support_action_attempt)

## record_support_action_receipt

Records an authenticated immutable authority receipt. Transport state changes alone never change a case or business action.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_actions/support-action:recordSupportActionReceipt` · scope `notify:support:receipts` · effect `write` · not available yet · validate_only · [Request, response and examples](/docs/api/support_actions/record_support_action_receipt)

## reconcile

Queries the original authority/key first; UNKNOWN remains UNCERTAIN. Only a verified NOT_APPLIED query receipt for the current attempt and uncertainty episode permits another attempt of the same action/key.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case/support_actions/support-action:reconcile` · scope `notify:support:reconcile` · effect `write` · not available yet · validate_only · [Request, response and examples](/docs/api/support_actions/reconcile)
