# Set a unique key once per new action; persist it and reuse it for every retry.
: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
: "${REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY:?Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example}"
curl --fail-with-body --max-time 30 -X POST 'https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve' \
-H "Authorization: Bearer $REFLECTIONS_KEY" \
-H "Reflections-Version: 2026-10-15" \
-H "Idempotency-Key: $REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"decision": "allow",
"note": "Approved."
}'import { env, exit } from "node:process";
// Set a unique key once per new action; persist it and reuse it for every retry.
const apiKey = env.REFLECTIONS_KEY;
if (!apiKey) throw new Error("Set REFLECTIONS_KEY before running this example");
const idempotencyKey = env.REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY;
if (!idempotencyKey) throw new Error("Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example");
const response = await fetch("https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve", {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Reflections-Version": "2026-10-15",
"Idempotency-Key": idempotencyKey,
"Content-Type": "application/json",
},
body: JSON.stringify({
"decision": "allow",
"note": "Approved."
}),
signal: AbortSignal.timeout(30_000),
});
const responseBody = await response.text();
if (!response.ok) {
console.error(`HTTP ${response.status}: ${responseBody}`);
exit(1);
}
console.log(responseBody);
import json
import os
from urllib.error import HTTPError
from urllib.request import Request, urlopen
# Set a unique key once per new action; persist it and reuse it for every retry.
apiKey = os.environ["REFLECTIONS_KEY"]
if not apiKey:
raise ValueError("Set REFLECTIONS_KEY before running this example")
idempotencyKey = os.environ["REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY"]
if not idempotencyKey:
raise ValueError("Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example")
headers = {
"Authorization": f"Bearer {apiKey}",
"Reflections-Version": "2026-10-15",
"Idempotency-Key": idempotencyKey,
"Content-Type": "application/json",
}
data = json.dumps({"decision": "allow", "note": "Approved."}).encode("utf-8")
request = Request("https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve",
method="POST", headers=headers, data=data)
try:
with urlopen(request, timeout=30) as response:
print(response.read().decode("utf-8"))
except HTTPError as error:
error_body = error.read().decode("utf-8")
raise RuntimeError(f"HTTP {error.code}: {error_body}") from error
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
"time"
)
func main() {
// Set a unique key once per new action; persist it and reuse it for every retry.
apiKey := os.Getenv("REFLECTIONS_KEY")
if apiKey == "" {
panic("Set REFLECTIONS_KEY before running this example")
}
idempotencyKey := os.Getenv("REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY")
if idempotencyKey == "" {
panic("Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example")
}
body := strings.NewReader(`{
"decision": "allow",
"note": "Approved."
}`)
request, err := http.NewRequest("POST", "https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve", body)
if err != nil {
panic(err)
}
request.Header.Set("Authorization", "Bearer " + apiKey)
request.Header.Set("Reflections-Version", "2026-10-15")
request.Header.Set("Idempotency-Key", idempotencyKey)
request.Header.Set("Content-Type", "application/json")
client := &http.Client{Timeout: 30 * time.Second}
response, err := client.Do(request)
if err != nil {
panic(err)
}
defer response.Body.Close()
responseBody, err := io.ReadAll(response.Body)
if err != nil {
panic(err)
}
if response.StatusCode < 200 || response.StatusCode >= 300 {
panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, responseBody))
}
fmt.Print(string(responseBody))
}
{
"id": "gen_bve7nfxeetkbstsfvqmvp4xjrr",
"object": "generation",
"livemode": false,
"check": "chk_nzrafkmpsmvkq48bptr2jjkakv",
"session": null,
"candidate_index": 0,
"artifact": {
"file": "file_gtxcsn02378bp8ms55h89gnny5",
"sha256": "d9c3fa0c6745dce267ccda24cd633f480cbcc47ec66f81840501f88ede082127",
"media_type": "image/png",
"duration_ms": null
},
"execution": {
"provider": "example-image-provider",
"model": "image-model-3",
"job_id": "job_88391"
},
"findings": [
{
"term": "license:lic_31x87g772xdcz1n1za29601rbt/terms.requiredAttributes",
"attribute": "identity.samePerson",
"result": "preserved"
}
],
"unchecked_terms": [],
"assurance": "observed",
"watermark": null,
"metadata": {},
"created_at": "2026-10-17T18:20:00Z",
"status": "released",
"decision": "allow",
"reasons": [],
"obligations": [
{
"type": "c2pa_manifest"
}
],
"escalation": {
"id": "esc_2rmfs05fb533m38c9vtj2v36p3",
"reason": "release_review",
"reviewer": "talent",
"status": "allowed",
"expires_at": "2026-10-24T18:20:00Z",
"resolved_at": "2026-10-17T18:26:14Z",
"note": "Approved."
},
"receipt": "rcpt_3e6gk07nyfq5v9vez6qr5t34bk",
"c2pa": {
"label": "ai.reflections.license",
"data": {
"receipt": "eyJhbGciOiJFUzI1NiIs…",
"verify_url": "https://app.reflections.ai/r/rcpt_3e6gk07nyfq5v9vez6qr5t34bk"
}
},
"decided_at": "2026-10-17T18:26:14Z"
}Resolve an escalation
Test mode available. Live mode unavailable. Resolves only your sandbox checks and generations. Requires an unrestricted test key; no webhook is sent.
Test mode only. Answers an open escalation as its reviewer would, so you can exercise
check.resolved, generation.released and generation.denied without a person.
Needs an unrestricted key.
# Set a unique key once per new action; persist it and reuse it for every retry.
: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
: "${REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY:?Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example}"
curl --fail-with-body --max-time 30 -X POST 'https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve' \
-H "Authorization: Bearer $REFLECTIONS_KEY" \
-H "Reflections-Version: 2026-10-15" \
-H "Idempotency-Key: $REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"decision": "allow",
"note": "Approved."
}'import { env, exit } from "node:process";
// Set a unique key once per new action; persist it and reuse it for every retry.
const apiKey = env.REFLECTIONS_KEY;
if (!apiKey) throw new Error("Set REFLECTIONS_KEY before running this example");
const idempotencyKey = env.REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY;
if (!idempotencyKey) throw new Error("Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example");
const response = await fetch("https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve", {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Reflections-Version": "2026-10-15",
"Idempotency-Key": idempotencyKey,
"Content-Type": "application/json",
},
body: JSON.stringify({
"decision": "allow",
"note": "Approved."
}),
signal: AbortSignal.timeout(30_000),
});
const responseBody = await response.text();
if (!response.ok) {
console.error(`HTTP ${response.status}: ${responseBody}`);
exit(1);
}
console.log(responseBody);
import json
import os
from urllib.error import HTTPError
from urllib.request import Request, urlopen
# Set a unique key once per new action; persist it and reuse it for every retry.
apiKey = os.environ["REFLECTIONS_KEY"]
if not apiKey:
raise ValueError("Set REFLECTIONS_KEY before running this example")
idempotencyKey = os.environ["REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY"]
if not idempotencyKey:
raise ValueError("Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example")
headers = {
"Authorization": f"Bearer {apiKey}",
"Reflections-Version": "2026-10-15",
"Idempotency-Key": idempotencyKey,
"Content-Type": "application/json",
}
data = json.dumps({"decision": "allow", "note": "Approved."}).encode("utf-8")
request = Request("https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve",
method="POST", headers=headers, data=data)
try:
with urlopen(request, timeout=30) as response:
print(response.read().decode("utf-8"))
except HTTPError as error:
error_body = error.read().decode("utf-8")
raise RuntimeError(f"HTTP {error.code}: {error_body}") from error
package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
"time"
)
func main() {
// Set a unique key once per new action; persist it and reuse it for every retry.
apiKey := os.Getenv("REFLECTIONS_KEY")
if apiKey == "" {
panic("Set REFLECTIONS_KEY before running this example")
}
idempotencyKey := os.Getenv("REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY")
if idempotencyKey == "" {
panic("Set REFLECTIONS_RESOLVE_TEST_ESCALATION_IDEMPOTENCY_KEY before running this example")
}
body := strings.NewReader(`{
"decision": "allow",
"note": "Approved."
}`)
request, err := http.NewRequest("POST", "https://app.reflections.ai/v1/test_helpers/escalations/esc_2rmfs05fb533m38c9vtj2v36p3/resolve", body)
if err != nil {
panic(err)
}
request.Header.Set("Authorization", "Bearer " + apiKey)
request.Header.Set("Reflections-Version", "2026-10-15")
request.Header.Set("Idempotency-Key", idempotencyKey)
request.Header.Set("Content-Type", "application/json")
client := &http.Client{Timeout: 30 * time.Second}
response, err := client.Do(request)
if err != nil {
panic(err)
}
defer response.Body.Close()
responseBody, err := io.ReadAll(response.Body)
if err != nil {
panic(err)
}
if response.StatusCode < 200 || response.StatusCode >= 300 {
panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, responseBody))
}
fmt.Print(string(responseBody))
}
{
"id": "gen_bve7nfxeetkbstsfvqmvp4xjrr",
"object": "generation",
"livemode": false,
"check": "chk_nzrafkmpsmvkq48bptr2jjkakv",
"session": null,
"candidate_index": 0,
"artifact": {
"file": "file_gtxcsn02378bp8ms55h89gnny5",
"sha256": "d9c3fa0c6745dce267ccda24cd633f480cbcc47ec66f81840501f88ede082127",
"media_type": "image/png",
"duration_ms": null
},
"execution": {
"provider": "example-image-provider",
"model": "image-model-3",
"job_id": "job_88391"
},
"findings": [
{
"term": "license:lic_31x87g772xdcz1n1za29601rbt/terms.requiredAttributes",
"attribute": "identity.samePerson",
"result": "preserved"
}
],
"unchecked_terms": [],
"assurance": "observed",
"watermark": null,
"metadata": {},
"created_at": "2026-10-17T18:20:00Z",
"status": "released",
"decision": "allow",
"reasons": [],
"obligations": [
{
"type": "c2pa_manifest"
}
],
"escalation": {
"id": "esc_2rmfs05fb533m38c9vtj2v36p3",
"reason": "release_review",
"reviewer": "talent",
"status": "allowed",
"expires_at": "2026-10-24T18:20:00Z",
"resolved_at": "2026-10-17T18:26:14Z",
"note": "Approved."
},
"receipt": "rcpt_3e6gk07nyfq5v9vez6qr5t34bk",
"c2pa": {
"label": "ai.reflections.license",
"data": {
"receipt": "eyJhbGciOiJFUzI1NiIs…",
"verify_url": "https://app.reflections.ai/r/rcpt_3e6gk07nyfq5v9vez6qr5t34bk"
}
},
"decided_at": "2026-10-17T18:26:14Z"
}Authorizations
Your secret key, rk_test_… or rk_live_…, sent as Authorization: Bearer <key>. Keep it
on your server. Restricted keys carry only the scopes you give them.
Headers
The dated API version. Defaults to the version your account is pinned to.
"2026-10-15"
Act for a connected licensee. The value is the licensee's account ID. Requires an active connection between that account and yours.
^acct_[0-9a-hjkmnp-tv-z]{26}$A unique key for this operation, up to 255 characters. In test mode, POST keys are scoped to your account and mode and bind the endpoint and body for 24 hours. A different endpoint or body with the same key is refused.
Initial live check and generation creation require a nonempty key. Each operation has a
separate account-scoped namespace; retain the same API key, body and idempotency key for
retries within 24 hours of creation. A pending check returns 202 with status: "checking".
Completed checks replay their sealed response; successful generation POSTs replay the
original accepted 202, so use GET for current state. Live verification is a read-only
query that returns a fresh verification ID on each call, without exact response caching.
The broader delegated-account contract also scopes keys to Reflections-Account;
delegated requests and the other planned live POST operations remain unsupported.
255Path Parameters
The escalation's ID, from escalation.id on the check or generation.
^esc_[0-9a-hjkmnp-tv-z]{26}$Body
Response
The resolved escalation's check or generation, as an event would carry it.
- Option 1
- Option 2
The check's ID, chk_ followed by 26 characters.
^chk_[0-9a-hjkmnp-tv-z]{26}$Always check.
"check"true in live mode, false in test mode.
Where the check is now. An allow can later become consumed, expired or
cancelled; an escalate ends allowed, denied or cancelled.
checking, allowed, denied, escalated, consumed, expired, cancelled allow, deny or escalate. An escalated check's decision becomes allow or deny
when a person decides or the escalation expires. Null while status is checking.
allow, deny, escalate Each protected talent the request invokes, with that talent's own decision and license. Empty when none is found.
Show child attributes
Show child attributes
The use the check decided, as you sent it.
Show child attributes
Show child attributes
Why the use was denied or escalated. Empty on allow.
Show child attributes
Show child attributes
What you must do to proceed. Empty unless decision is allow.
Show child attributes
Show child attributes
Digest of the inputs, use and execution this check decided. Without reuse, the authorization covers only this request; with reuse, it also covers later generations of the same use, talent, execution and end user.
^sha256:[0-9a-f]{64}$When the check was created.
Proof of the allow. Pass token to the tool or provider that generates. Null unless
decision is allow.
Show child attributes
Show child attributes
The escalation, when the check is escalated or was decided by a person. When several
talent are escalated, each has their own, named in talent[].escalation. While the
check is open, this field shows the open one that expires first, so its expires_at is
when the check becomes deny. Once decided, it shows the one that decided: the first
deny or expiry, or the last allow. The others still open are then cancelled.
Show child attributes
Show child attributes
What would change a deny. Null for other decisions, and when no change can help, as
with talent_prohibits.
Show child attributes
Show child attributes
The account that holds the license: the licensee named in Reflections-Account, or your
own account under a platform license.
^acct_[0-9a-hjkmnp-tv-z]{26}$The account that ran the check.
^acct_[0-9a-hjkmnp-tv-z]{26}$The session this check started, for a check run by POST /v1/sessions. Null otherwise.
^ses_[0-9a-hjkmnp-tv-z]{26}$The receipt that records the decision. Null until an escalated check is decided.
^rcpt_[0-9a-hjkmnp-tv-z]{26}$Your metadata from the request.
Show child attributes
Show child attributes