Spyderbat Watchlist API
An API to manage the watchlist for files within an organization.
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/spyderbat:spyderbat-watchlist-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: Spyderbat API UI & Public Watchlist API
description: Restful APIs for use by UI & customers.
termsOfService: https://www.spyderbat.com/terms-of-use/
contact:
name: API Support
url: https://api.prod.spyderbat.com/openapi
email: support@spyderbat.com
license:
name: MIT
url: https://mit-license.org/
version: 1.0.0
x-logo:
url: /static/sb-logo.svg
backgroundColor: '#161A21'
altText: Spyderbat Logo
servers:
- url: https://api.prod.spyderbat.com/
description: Spyderbat API Server
security:
- apiToken: []
tags:
- name: Watchlist
description: An API to manage the watchlist for files within an organization.
paths:
/api/v1/org/{orgUID}/files/watchlist:
get:
tags:
- Watchlist
summary: Query watchlist entries
description: 'This will query the watchlist entries for an org
* Requires the action *org:QueryWatchlist* on the organization'
operationId: WatchlistQuery
parameters:
- name: orgUID
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DaoWatchlist'
'403':
description: permission denied
post:
tags:
- Watchlist
summary: Create a watchlist entry
description: 'This will create a new watchlist entry for an org
* Requires the action *org:CreateWatchlist* on the organization'
operationId: WatchlistCreate
parameters:
- name: orgUID
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WatchlistCreateInput'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ApiWatchlistCreateHandlerOutput'
'400':
description: invalid input parameters
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
'403':
description: permission denied
/api/v1/org/{orgUID}/files/watchlist/{watchlistID}:
get:
tags:
- Watchlist
summary: Load a watchlist entry
description: 'This will retrieve a specific watchlist entry for an org
* Requires the action *org:LoadWatchlist* on the organization'
operationId: WatchlistLoad
parameters:
- name: orgUID
in: path
required: true
schema:
type: string
- name: watchlistID
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DaoWatchlist'
'403':
description: permission denied
'404':
description: not found
put:
tags:
- Watchlist
summary: Update a watchlist entry
description: 'This will update a specific watchlist entry for an org
* Requires the action *org:UpdateWatchlist* on the organization'
operationId: WatchlistUpdate
parameters:
- name: orgUID
in: path
required: true
schema:
type: string
- name: watchlistID
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WatchlistUpdateInput'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DaoWatchlist'
'400':
description: invalid input parameters
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
'403':
description: permission denied
delete:
tags:
- Watchlist
summary: Delete a watchlist entry
description: 'This will delete the specified watchlist entry from an org
* Requires the action *org:DeleteWatchlist* on the organization'
operationId: WatchlistDelete
parameters:
- name: orgUID
in: path
required: true
schema:
type: string
- name: watchlistID
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
'403':
description: permission denied
components:
schemas:
DaoWatchlist:
type: object
properties:
files:
type: array
items:
type: string
id:
type: string
name:
type: string
org_uid:
type: string
resource_name:
type: string
description: Resource name utilized by RBAC
updated_at:
type: string
valid_from:
type: string
ApiWatchlistCreateHandlerOutput:
type: object
properties:
id:
type: string
ValidationError:
type: object
properties:
err_msg:
type: string
description: Message regarding the validation failure
field:
type: string
description: Field name which failed validation
property:
type: string
description: JSON property name of the field which failed validation
tags:
type: string
description: Validation tag which failed
WatchlistCreateInput:
type: object
properties:
files:
type: array
items:
type: string
name:
type: string
required:
- files
- name
WatchlistUpdateInput:
type: object
properties:
files:
type: array
items:
type: string
name:
type: string
required:
- files
- name
securitySchemes:
apiToken:
type: http
scheme: bearer
bearerFormat: JWT
x-provenance:
method: harvested
publisher: Spyderbat
source: https://api.prod.spyderbat.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)