XFiltered

EVALUATE A SUBMITTED POST

Evaluate a post you submit now.

XFiltered evaluates a post you submit now. Automatic X watching needs an approved credential. It does not expose a social feed. Evaluate a post you submit now. Automatic X watching needs an approved credential.

Source requirement

Live ingestion requires an approved, funded official X API bearer token. X does not currently provide a compliant recurring-free read tier for this workload. User-submitted evaluations remain available without an X connection.

Quickstart

  1. 01

    Describe what matters

    Evaluate a post you submit now. Automatic X watching needs an approved credential. Drafting and user-submitted evaluations remain available without an X connection.

  2. 02

    Define strict output

    Provide a strict JSON Schema. Every saved change creates an immutable version. Evaluate a post you submit now. Automatic X watching needs an approved credential.

  3. 03

    Verify the destination

    Create an HTTPS webhook, store its one-time signing secret, and send a real signed test.

  4. 04

    Evaluate a post you submit now

    Evaluate a post you submit now. Automatic X watching needs an approved credential. Drafting and user-submitted evaluations remain available without an X connection. Connect an approved official X bearer token only for live ingestion. XFiltered encrypts the token and does not return it. Evaluate a post you submit now. Automatic X watching needs an approved credential.

Evaluate a submitted post

Evaluate a post you submit now. Automatic X watching needs an approved credential.

Evaluate a post you submit now.

An accepted match creates one logical execution. A dispatch is created only after successful extraction when the current pipeline and destination are active. Successful extraction without an active current pipeline and destination remains matched and creates no delivery. Extraction failure creates no delivery. A delivery receives five total attempts with backoff at 1 minute, 5 minutes, 15 minutes, and 1 hour. Exhausted attempts move to the dead-letter queue, where an operator can repair the destination and explicitly replay the isolated event.

extracting→extraction failedormatchedordispatch pending→deliveredordead lettered

Source limitations

Evaluate a post you submit now. Automatic X watching needs an approved credential. When an approved official X credential is connected, coverage is limited to the connected access tier, the configured query, and X's recent-search window. Polling is checkpointed with since_id. Provider costs and rate limits remain the workspace owner's responsibility.

Webhook verification

Receivers must compute HMAC-SHA256 over timestamp + "." + rawRequestBody using the one-time destination secret. Compare it to x-xfiltered-signature after removing the v1= prefix, reject stale timestamps, and deduplicate on x-xfiltered-idempotency-key.

  • HTTP method: POST with a five-second timeout
  • Content type: application/json
  • Event name: x-xfiltered-event
  • Event identity: x-xfiltered-event-id
  • Signature timestamp: x-xfiltered-timestamp
  • At-least-once key: x-xfiltered-idempotency-key