Skip to main content
POST
Create a Bluesky watch

Authorizations

x-api-key
string
header
required

API key created from the Nephia dashboard for your Account.

Headers

Idempotency-Key
string

Unique key (e.g. UUID) making this POST safe to retry for 24 hours. Replays return the original response with an Idempotency-Replayed: true header; reusing a key with a different body returns 422.

Maximum string length: 255

Body

application/json
refresh_interval_seconds
number
required
Required range: 120 <= x <= 86400
query
string
Minimum string length: 1
author
string
Minimum string length: 1
lang
string
Required string length: 2 - 8
webhook_url
string<uri>
ai
object
backfill
boolean
match
enum<string>

How strictly results must carry your query. Omit for the platform's own matching (default). word keeps only items containing the query as a whole word (and quotes it upstream where the platform honours quotes); contains keeps items containing it as a substring.

Available options:
platform,
word,
contains

Response

Watch created

id
string
required
accountId
string
required
source
enum<string>
required
Available options:
x,
reddit,
youtube,
tiktok,
bluesky,
hackernews,
mastodon,
lemmy,
github,
producthunt,
stackoverflow,
rss,
ai_answers,
vinted
market
string
required
criteria
object
required
criteriaHash
string
required
refreshIntervalSeconds
number
required
webhookUrl
string | null
required
billingMode
enum<string>
required
Available options:
subscription,
payg,
deferred,
metered
isActive
boolean
required
createdAt
string
required
updatedAt
string
required
pausedReason
string | null