Impri Watchers API
The Watchers API from Impri — 2 operation(s) for watchers.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/impri-dev:impri-dev-watchers-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Impri Watchers API
version: v1
description: Human-in-the-loop approval API for AI agents. POST an action, get a decision back via webhook or polling. The imprimatur for your AI agents.
servers:
- url: https://api.impri.dev/v1
description: API v1
security:
- bearerAuth: []
tags:
- name: Watchers
paths:
/watchers:
post:
operationId: createWatcher
summary: Create a watcher (watch scope)
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateWatcherBody'
responses:
'201':
description: Watcher created
'400':
description: Validation error
'429':
description: Rate limit exceeded
tags:
- Watchers
get:
operationId: listWatchers
summary: List watchers with optional filters
parameters:
- name: status
in: query
schema:
type: string
enum:
- active
- paused
- degraded
- name: kind
in: query
schema:
type: string
enum:
- rss
- reddit_search
- url_diff
- name: limit
in: query
schema:
type: integer
default: 50
- name: cursor
in: query
schema:
type: string
responses:
'200':
description: Paginated list of watchers
tags:
- Watchers
/watchers/{id}:
get:
operationId: getWatcher
summary: Get a single watcher with item count
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Watcher
'404':
description: Not found
tags:
- Watchers
patch:
operationId: updateWatcher
summary: Update a watcher (name/config/schedule/status)
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateWatcherBody'
responses:
'200':
description: Updated watcher
'404':
description: Not found
tags:
- Watchers
delete:
operationId: deleteWatcher
summary: Delete a watcher and its dedup items
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Deleted
'404':
description: Not found
tags:
- Watchers
components:
schemas:
CreateWatcherBody:
$ref: '#/components/schemas/CreateWatcherBody'
definitions:
CreateWatcherBody:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 200
kind:
type: string
enum:
- rss
- reddit_search
- url_diff
config:
type: object
properties:
url:
type: string
format: uri
query:
type: string
minLength: 1
maxLength: 500
subreddit:
type: string
minLength: 1
maxLength: 100
additionalProperties: false
keywords:
type: array
items:
type: object
properties:
pattern:
type: string
minLength: 1
maxLength: 500
points:
type: integer
minimum: 1
maximum: 100
required:
- pattern
- points
additionalProperties: false
default: []
keywords_none:
type: array
items:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
default: []
min_score:
type: integer
minimum: 0
default: 1
schedule:
type: object
properties:
every:
type: string
pattern: ^\d+[mhd]$
jitter:
type: string
pattern: ^\d+[mhd]$
window:
type: string
pattern: ^\d{2}:\d{2}-\d{2}:\d{2}$
required:
- every
additionalProperties: false
color:
anyOf:
- type: string
pattern: ^#[0-9a-fA-F]{6}$
- type: 'null'
required:
- name
- kind
- config
- schedule
additionalProperties: false
$schema: http://json-schema.org/draft-07/schema#
UpdateWatcherBody:
$ref: '#/components/schemas/UpdateWatcherBody'
definitions:
UpdateWatcherBody:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 200
config:
type: object
properties:
url:
type: string
format: uri
query:
type: string
minLength: 1
maxLength: 500
subreddit:
type: string
minLength: 1
maxLength: 100
additionalProperties: false
keywords:
type: array
items:
type: object
properties:
pattern:
type: string
minLength: 1
maxLength: 500
points:
type: integer
minimum: 1
maximum: 100
required:
- pattern
- points
additionalProperties: false
keywords_none:
type: array
items:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
min_score:
type: integer
minimum: 0
schedule:
type: object
properties:
every:
type: string
pattern: ^\d+[mhd]$
jitter:
type: string
pattern: ^\d+[mhd]$
window:
type: string
pattern: ^\d{2}:\d{2}-\d{2}:\d{2}$
required:
- every
additionalProperties: false
status:
type: string
enum:
- active
- paused
color:
anyOf:
- type: string
pattern: ^#[0-9a-fA-F]{6}$
- type: 'null'
additionalProperties: false
$schema: http://json-schema.org/draft-07/schema#
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: im_<key>