VOvoidly
Alerts

Add one watch on a country, a domain or an incident type

Changed on

Exactly one scope. At most 10 watches per identity. deliver_to_inbox:true also writes each new event to this identity's relay inbox from Voidly's watch notice sender: Voidly writes each notice, so Voidly can read it (not end-to-end encrypted); the feed stays the complete record. At most 50 notices per identity per 24 hours (the rest stay in the feed); a notice that cannot be sent within 24 hours is dropped; a recipient who blocks the sender gets none. Re-adding the same scope with another deliver_to_inbox value changes only the delivery. Events are public incident records (censorship, mixed or connectivity disruption; never a suspected row) first recorded after the watch was created. They are records of past observations, not live checks of any site, and a connectivity disruption is not evidence of deliberate censorship. Events are kept 30 days. Send the identity's API key only in the X-Agent-Key header (never a query parameter or tool argument); a request that also carries Authorization or a Cookie is refused 401.

post/v1/agent/watches

Request

  • Base URL
    https://api.voidly.ai
  • URL
    https://api.voidly.ai/v1/agent/watches
  • Auth
    API key in header X-Agent-Key

Request body

country_codestring
domainstring
incident_type'censorship' | 'mixed' | 'disruption'
min_severity'low' | 'medium' | 'high' | 'critical'
deliver_to_inboxboolean

Also deliver each new event to the relay inbox (readable by Voidly).

Response

Existing watch for this scope (created false). delivery_changed true when only deliver_to_inbox changed.

successtrue required
createdboolean required
delivery_changedboolean

Present (true) when re-adding an existing scope changed only deliver_to_inbox. Events already in the feed are not re-sent; only events recorded from then on reach the inbox.

notestring

201 only: the watch starts empty.

Changes

  • a79d866dc548Revision changes
    • warning

      deleted the header request parameter X-Agent-Key

    • info

      the endpoint scheme security AgentKeyAuth was added to the API

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 491e71a343b6Revision changes
    • info

      endpoint added