Voices

Withdraw a likeness approval: no new pictures or videos of that person.

From now on, a picture or video that would show that person is refused (422 likeness_consent_required). Work already published stays up. Final and idempotent. 404 likeness_consent_not_found for an id that is not this account's. Free. Requires Idempotency-Key. Scope: story:write.

post/likeness-consents/{consentId}/revoke

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/likeness-consents/{consentId}/revoke
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Customer-generated stable identifier for safe retries of idempotent POST requests.

Response

The approval, withdrawn.

idstring required
subjectNamestring required

Whose likeness it is.

subjectType'self' | 'living_third_party' | 'estate' required

self: the account holder; living_third_party: the person approved; estate: approved by a recently deceased person's estate.

recordedAtstring date-time required
revokedAtstring date-time nullable required
status'active' | 'revoked' required

Changes

No recorded changes to this operation across all 2 revisions of this API.