Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

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

Reflections-Version
string

The dated API version. Defaults to the version your account is pinned to.

Example:

"2026-10-15"

Reflections-Account
string

Act for a connected licensee. The value is the licensee's account ID. Requires an active connection between that account and yours.

Pattern: ^acct_[0-9a-hjkmnp-tv-z]{26}$

Path Parameters

revocation_id
string
required

The revocation's ID.

Pattern: ^rvk_[0-9a-hjkmnp-tv-z]{26}$

Response

The revocation.

id
string
required

The revocation's ID. Pass it as after to read the revocations created after it.

Pattern: ^rvk_[0-9a-hjkmnp-tv-z]{26}$
object
string
required

Always revocation.

Allowed value: "revocation"
livemode
boolean
required

true in live mode, false for an object created with a test key.

scope
enum<string>
required

license: one license. facet: a facet withdrawn, which narrows every license that covers it. mandate: a representative's authority ended. talent: consent withdrawn everywhere.

Available options:
license,
facet,
mandate,
talent
targets
object
required

What the revocation cuts. Which fields are set depends on scope.

status
enum<string>
required

pending_acknowledgement until every required action is acknowledged, then acknowledged, or overdue if a deadline passes first.

Available options:
pending_acknowledgement,
acknowledged,
overdue
initiated_by
enum<string>
required

Who revoked: the talent in the Talent Portal, a representative whose mandate has revoke, or Reflections.

Available options:
talent,
representative,
reflections
effective_at
string<date-time>
required

When the revocation took effect. acknowledge_by is 24 hours later.

required_actions
enum<string>[]
required

What every platform that used the targets must do and acknowledge.

stop_generation: issue nothing new under the targets. purge_cached_decisions: drop cached checks and authorizations. delete_provider_copies: delete copies held at model providers, such as voices. cease_distribution: place released outputs nowhere new. withdraw_outputs: take released outputs down.

Available options:
stop_generation,
purge_cached_decisions,
delete_provider_copies,
cease_distribution,
withdraw_outputs
acknowledge_by
string<date-time>
required

When every required action except withdraw_outputs must be acknowledged: 24 hours after effective_at.

acknowledgements
object[]
required

Each acknowledgement a platform sent, in the order received. Shown on the talent's record.

created_at
string<date-time>
required

When Reflections recorded the revocation.

for_cause
boolean

Revoked for a breach. Only then can withdraw apply.

cause
string | null

For a revocation for cause, the breach, as whoever revoked it stated it.

note
string | null

A note from whoever revoked it.

post_revocation
object

What happens to outputs released before effective_at, copied from the license's post_revocation term.

provider_copies
object[]

Copies at model providers you must delete.

affected
object

What the revocation cut, at effective_at.