---
# @generated by sylphx-gen. Do not edit.
title: "Reveal support requester on a support case"
description: "`notify.support_cases.reveal_support_requester` (POST /v1/{name}:revealSupportRequester): Reveals the protected case requester under a purpose-bound grant and appends an audited read."
type: reference
product: support
summary: "Reveals the protected case requester under a purpose-bound grant and appends an audited read."
updated: 2026-09-28
nav: false
---

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

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

**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:revealSupportRequester`
- **Scope** `notify:support:reveal`
- **Effect** `write` — a successful call changes state.
- **Collection** [support_cases](/docs/api/support_cases)
- **Validate-only** `validate_only=true` runs every check and writes nothing

## Request

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | Canonical resource name, checked against the caller grant. Required. |
| `expected_version` | `int64` | Optimistic version precondition; mismatch returns ETAG_MISMATCH. Required. |
| `request_id` | `string` | Stable UUID for this logical operation. |
| `validate_only` | `bool` | Validate without changing state or contacting an effect provider. |
| `reason` | `string` | Purpose of accessing unmasked personal data. Required. |

## Response

| Field | Type | What it is |
| --- | --- | --- |
| `identity` | `string` | Unmasked source identity, possibly a synthetic channel address. Never returned again. |
| `audit_event` | `string` | Audit record of this access. |

## Errors

- [`UNAUTHENTICATED`](/docs/api/errors/UNAUTHENTICATED) — No valid key or token was presented.
- [`PERMISSION_DENIED`](/docs/api/errors/PERMISSION_DENIED) — The key lacks the method's permission.
- [`INVALID_FIELD`](/docs/api/errors/INVALID_FIELD) — A field failed validation.
- [`RESOURCE_NOT_FOUND`](/docs/api/errors/RESOURCE_NOT_FOUND) — The named Resource does not exist or is not visible.
- [`ETAG_MISMATCH`](/docs/api/errors/ETAG_MISMATCH) — The etag sent does not match the Resource's current etag.
- [`INVALID_STATE`](/docs/api/errors/INVALID_STATE) — The Resource is in a state that forbids the call.
- [`UNAVAILABLE`](/docs/api/errors/UNAVAILABLE) — The Resource store, the owning service's backend, or the key verifier's snapshot is unavailable; retry after Retry-After.
- [`UNIMPLEMENTED`](/docs/api/errors/UNIMPLEMENTED) — The path or method is not served (yet) at this version.
- [`IDEMPOTENCY_KEY_REUSED`](/docs/api/errors/IDEMPOTENCY_KEY_REUSED) — An Idempotency-Key was reused with another body.
- [`IDEMPOTENCY_IN_PROGRESS`](/docs/api/errors/IDEMPOTENCY_IN_PROGRESS) — The first call with this Idempotency-Key is still running.

Every error arrives in the body [Errors](/docs/platform/errors) describes.

## Examples

**cURL**

```curl
curl -X POST "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/support_cases/support-case:revealSupportRequester" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expected_version":1,"reason":"…"}'
```

**TypeScript**

```ts
const response = await sylphx.notify.supportCases.revealSupportRequester({ expectedVersion: 1, name: 'orgs/acme/projects/shop/envs/production/support_cases/support-case', reason: '…' })
```

**Rust**

```rust
let mut req = sylphx::notify::RevealSupportRequesterRequest::default();
req.expected_version = 1;
req.name = "orgs/acme/projects/shop/envs/production/support_cases/support-case".to_string();
req.reason = "…".to_string();
let response = sx.notify().support_cases().reveal_support_requester(req).await?;
```

**CLI**

```bash
sylphx notify support-cases reveal-support-requester orgs/acme/projects/shop/envs/production/support_cases/support-case
```

**MCP**

```json
{ "method_id": "notify.support_cases.reveal_support_requester", "args": {"expected_version":1,"name":"orgs/acme/projects/shop/envs/production/support_cases/support-case","reason":"…"} }
```
