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/elementum:elementum-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: Elementum Watchers API
description: Manage the watchers of a record
contact:
email: apiteam@elementum.io
version: 0.0.1
servers:
- url: /v1
tags:
- name: Watchers
description: Manage the watchers of a record
paths:
/{recordType}/{alias}/{id}/watchers:
get:
tags:
- Watchers
summary: Get the list of watchers
operationId: listRecordWatchers
parameters:
- $ref: '#/components/parameters/recordType'
- $ref: '#/components/parameters/alias'
- $ref: '#/components/parameters/recordId'
- $ref: '#/components/parameters/first'
- $ref: '#/components/parameters/after'
- $ref: '#/components/parameters/last'
- $ref: '#/components/parameters/before'
responses:
'200':
description: Ok
content:
application/json:
schema:
$ref: '#/components/schemas/WatcherPagedList'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'422':
$ref: '#/components/responses/422'
'429':
$ref: '#/components/responses/429'
'500':
$ref: '#/components/responses/500'
security:
- ClientCredentials: []
x-codegen-request-body-name: body
post:
tags:
- Watchers
summary: Add a watcher
operationId: createRecordWatchers
parameters:
- $ref: '#/components/parameters/recordType'
- $ref: '#/components/parameters/alias'
- $ref: '#/components/parameters/recordId'
requestBody:
description: The watcher to be added
content:
application/json:
schema:
$ref: '#/components/schemas/WatcherListInput'
required: true
responses:
'201':
description: Created
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'422':
$ref: '#/components/responses/422'
'429':
$ref: '#/components/responses/429'
'500':
$ref: '#/components/responses/500'
security:
- ClientCredentials: []
x-codegen-request-body-name: body
delete:
tags:
- Watchers
summary: Delete a watcher
operationId: deleteRecordWatchers
parameters:
- $ref: '#/components/parameters/recordType'
- $ref: '#/components/parameters/alias'
- $ref: '#/components/parameters/recordId'
requestBody:
description: The watcher to be removed
content:
application/json:
schema:
$ref: '#/components/schemas/WatcherListInput'
required: true
responses:
'200':
description: Ok
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'422':
$ref: '#/components/responses/422'
'429':
$ref: '#/components/responses/429'
'500':
$ref: '#/components/responses/500'
security:
- ClientCredentials: []
x-codegen-request-body-name: body
components:
parameters:
recordType:
name: recordType
in: path
description: '''apps'', ''elements'', ''tasks'', or ''transactions'''
required: true
schema:
type: string
format: string
alias:
name: alias
in: path
description: The app's namespace or its UUID
required: true
schema:
type: string
format: string
before:
name: before
in: query
description: The starting cursor to begin searching, defaults to the end of the list
required: false
schema:
type: string
first:
name: first
in: query
description: The number of elements to retrieve after the 'after' cursor location
required: false
schema:
maximum: 1000
minimum: 1
type: integer
format: int32
default: 100
recordId:
name: id
in: path
description: The record ID
required: true
schema:
type: string
format: string
after:
name: after
in: query
description: The starting cursor to begin searching, defaults to the beginning of the list
required: false
schema:
type: string
last:
name: last
in: query
description: The number of elements to retrieve before the 'before' cursor location
required: false
schema:
maximum: 1000
minimum: 1
type: integer
format: int32
schemas:
PagingState:
type: object
properties:
has_next_page:
type: boolean
end_cursor:
type: string
start_cursor:
type: string
has_previous_page:
type: boolean
WatcherPagedList:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/Watcher'
total:
type: integer
format: int32
paging:
$ref: '#/components/schemas/PagingState'
example:
items:
- id: 550e8400-e29b-41d4-a716-446655440000
target:
firstName: Jane
type: User
email: jane@example.com
lastName: Doe
id: 550e8400-e29b-41d4-a716-446655440001
- id: 550e8400-e29b-41d4-a716-446655440002
target:
type: Group
id: 550e8400-e29b-41d4-a716-446655440003
name: Engineering
total: 2
paging:
has_next_page: false
end_cursor: cHJvY2Vzc0RlZmluaXRpb25zfDA=
start_cursor: Ijf7eqZc0RlZmluaXRpb25zfDA=
has_previous_page: false
WatcherTarget:
type: object
properties:
id:
type: string
description: The target ID
format: uuid
firstName:
type: string
description: The user's first name (User targets only)
lastName:
type: string
description: The user's last name (User targets only)
name:
type: string
description: The group name (Group targets only)
email:
type: string
description: The user's email (User targets only)
type:
type: string
description: The watcher target type (User or Group)
WatcherListInput:
type: object
properties:
users:
type: array
items:
type: string
format: email
example:
users:
- user1@email.com
- user2@email.com
Watcher:
type: object
properties:
id:
type: string
description: The watcher ID
format: uuid
target:
$ref: '#/components/schemas/WatcherTarget'
responses:
'401':
description: Unauthorized
'400':
description: Bad Request
'429':
description: Too Many Requests
'404':
description: Not Found
'500':
description: Internal Server Error
'403':
description: Forbidden
'422':
description: Unprocessable Entity
securitySchemes:
ClientCredentials:
type: oauth2
flows:
clientCredentials:
tokenUrl: /oauth/token
externalDocs:
description: Find out more about Elementum
url: https://www.elementum.com/
x-provenance:
method: harvested
publisher: Elementum
source: https://api.elementum.io/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)