> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reflections.ai/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> The OpenAPI document at /api-reference/openapi.yaml defines the target contract. Its x-reflections-availability field and each operation's availability notice identify supported test and live forms. Do not infer implementation from a schema or code sample. Live keys support account details, reads of the licenses the calling account holds as licensee or issued as talent (GET /v1/licenses?role=issuer), and GET /v1/generations?license=… for the state of outputs under such a license (summaries only: no prompt, reference, bytes or metadata). Live image checks, submissions and receipts are built but not activated: until activation, a live POST /v1/checks or /v1/generations returns 403 live_not_activated, which must not be retried. Discovery and JWKS are at the origin root (https://app.reflections.ai/.well-known/...), not under /v1.
> Three rules hold everywhere: a decision is never an error (deny and escalate are 200 responses, and a live check still evaluating is a 202 with status checking); generate nothing for a named talent without an allow; deliver nothing until the generation is allow.
> The sandbox accepts personal rk_test_ keys. Persist a separate Idempotency-Key and body for each logical /v1 POST; retry an unknown outcome with the same key and body. OAuth and Talent API MCP remain planned.
# connection.revoked
> A connection ended.
Planned protocol reference. The current Talent API sandbox does not register webhook endpoints
or deliver events. Use polling and the test escalation helper for supported sandbox
transitions.
Start with the [runnable quickstart](/quickstart) and [sandbox support matrix](/sandbox).
## What to do
1. Stop sending checks for the licensee. They fail with `account_not_connected`.
2. Tell the licensee's users in your product that their licensed talent is no longer available.
Return a `2xx` within 10 seconds, then do the work. Deliveries can repeat; ignore an event ID you have processed.
## Related
## OpenAPI
````yaml api-reference/openapi.yaml webhook connection.revoked
openapi: 3.1.0
info:
title: Reflections Talent API
version: '2026-10-15'
summary: The license server for a person's name, likeness and voice in generative AI.
description: >
This document defines the target Talent API contract. Each operation
declares its current
test and live availability. Test mode serves a limited fictional sandbox.
Live keys support
account details and reading the caller's own licenses. The initial live
image check,
submission and receipt implementation is deployed, but requires separate
live signing
activation and production acceptance. Start at
https://docs.reflections.ai/quickstart for test mode.
The target API lets any product that can generate a real person check
whether a use is licensed,
verify the output it made, prove that verification to anyone downstream,
report usage, and
honor revocations.
Protected requests use a secret key in the `Authorization` header. The
target contract defines test keys
(`rk_test_…`) and live keys (`rk_live_…`) use the same base URL; the key
decides the mode.
A decision is never an error. `deny` and `escalate` are `200` responses that
carry a decision.
Errors use RFC 9457 problem details.
contact:
name: Reflections developer support
url: https://docs.reflections.ai/production/support
email: developers@reflections.ai
servers:
- url: https://app.reflections.ai/v1
description: >-
Fictional test sandbox and conditional live support; availability and
activation are separate
security:
- SecretKey: []
tags:
- name: Account
description: The account that owns the calling key.
- name: Talent
description: >-
People whose name, likeness and voice are protected and licensed through
Reflections.
- name: Facets
description: >-
The parts of a talent's identity a license can cover, such as a voice or a
likeness.
- name: Resolutions
description: Find which talent a prompt, image or voice sample invokes.
- name: Licenses
description: Signed licenses and their revisions.
- name: License requests
description: Ask a talent for a new license or a wider one.
- name: Connections
description: A licensee's permission for a platform to use its licenses.
- name: Files
description: References and outputs uploaded for checks and generations.
- name: Checks
description: Decide whether a use may proceed, before anything is generated.
- name: Generations
description: Check an output against the license its check relied on.
- name: Sessions
description: Authorize live voice and video with short-lived tokens and sampled checks.
- name: Receipts
description: Signed, portable proof of a decision.
- name: Verifications
description: Verify a file, manifest or receipt.
- name: Revocations
description: Every narrowing of consent, and the platform's acknowledgement of it.
- name: Usage records
description: Report usage for settlement and audit.
- name: Statements
description: Monthly amounts owed under a license, reconciled against observed usage.
- name: Mandates
description: A representative's authority to act for a talent, and its powers.
- name: Escalations
description: >-
The review queue. Checks and held outputs waiting for the talent's side to
decide.
- name: License drafts
description: Terms prepared for a talent's signature. Only a person signs.
- name: Webhook endpoints
description: Where Reflections sends events.
- name: Events
description: The record of everything that happened to your objects.
- name: Test helpers
description: Act as a talent or reviewer in test mode.
- name: Discovery
description: The public discovery document and signing keys. Neither needs a key.
- name: OAuth
description: >
Authorization for connections, MCP clients and RSL clients, and the
metadata that describes it.
paths: {}
components:
securitySchemes:
SecretKey:
type: http
scheme: bearer
description: >
Your secret key, `rk_test_…` or `rk_live_…`, sent as `Authorization:
Bearer `. Keep it
on your server. Restricted keys carry only the scopes you give them.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.