Skip to main content

Guidance

SASHA-evaluated distribution guidance for a found signature.

Guidance reflects the distribution intent the creator declared to SASHA. It is not a determination of the legal status of the media; rights such as copyright apply independently of the returned advice. The underlying Record contents are never disclosed, though the optional message may name domains from the Record's allowed URL patterns (domain names are public knowledge).

share_stateShareState (string)required

The creator-declared share state of a protected media item:

  • private: The creator declared that the media is not intended to be distributed anywhere public
  • unrestricted: The creator declared no distribution restrictions for the media
  • restricted: The creator declared that the media is intended to be distributed only where the Record's distribution fields permit

A share state describes only the intent the creator has declared to SASHA. It is not a statement about the legal status of the media; rights such as copyright apply independently.

Possible values: [private, unrestricted, restricted]

advicestringrequired

The verdict for the queried location and time:

  • allowed: Presence of the media at the queried location at the current time is consistent with the creator's declared distribution intent
  • not_allowed: Presence of the media at the queried location at the current time conflicts with the creator's declared distribution intent, or the creator declared the media as not intended for public distribution
  • inconclusive: No conclusive verdict could be produced, typically because the share state is restricted and no publish_url or source_url was supplied with the lookup

Possible values: [allowed, not_allowed, inconclusive]

messagestring

Human-readable explanation of the verdict, e.g. "Only allowed on example.com".

Populated at the server's discretion, typically when advice is not_allowed or inconclusive. For developer convenience only: English, not localized, and the wording is not stable across releases — never parse or branch on it; use advice and share_state for program logic. The text may name domains from the Record's allowed URL patterns (domain names are public knowledge and are not masked); it never carries full URL patterns or other raw Record content.

Guidance
{
  "share_state": "private",
  "advice": "allowed",
  "message": "string"
}