Clarity Operators API
The operators API from Clarity — 4 operation(s) for operators.
The operators API from Clarity — 4 operation(s) for operators.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/onclarity-com:onclarity-com-operators-api"
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.
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: 3.2.0
info:
title: Fast Operators API
version: 0.1.0
tags:
- name: Operators
paths:
/api/v1/operators/list:
post:
tags:
- Operators
summary: List Operators
operationId: list_operators_api_v1_operators_list_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListOperatorsRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/v1/operators/preview:
post:
tags:
- Operators
summary: Preview Operator
operationId: preview_operator_api_v1_operators_preview_post
security:
- HTTPBearer: []
parameters:
- name: api_url
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Api Url
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PreviewOperatorRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/operators/create:
post:
tags:
- Operators
summary: Add Operator
operationId: add_operator_api_v1_operators_create_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateOperatorRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/v1/operators/{operator_id}:
post:
tags:
- Operators
summary: Get Operator
operationId: get_operator_api_v1_operators__operator_id__post
security:
- HTTPBearer: []
parameters:
- name: operator_id
in: path
required: true
schema:
type: integer
title: Operator Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- Operators
summary: Update Operator
operationId: update_operator_api_v1_operators__operator_id__put
security:
- HTTPBearer: []
parameters:
- name: operator_id
in: path
required: true
schema:
type: integer
title: Operator Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateOperatorRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Operators
summary: Delete Operator
operationId: delete_operator_api_v1_operators__operator_id__delete
security:
- HTTPBearer: []
parameters:
- name: operator_id
in: path
required: true
schema:
type: integer
title: Operator Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
PreviewOperatorRequest:
properties:
operators:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
title: Operators
tickets:
items:
additionalProperties: true
type: object
type: array
title: Tickets
override_config:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Override Config
additionalProperties: false
type: object
required:
- tickets
title: PreviewOperatorRequest
description: Dry-run one or more operator configs against sample tickets via DIS.
ListOperatorsRequest:
properties: {}
type: object
title: ListOperatorsRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
CreateOperatorRequest:
properties:
name:
type: string
title: Name
filters:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
title: Filters
default: []
tasks:
items:
additionalProperties: true
type: object
type: array
title: Tasks
params:
additionalProperties: true
type: object
title: Params
default: {}
template:
anyOf:
- type: string
- type: 'null'
title: Template
consumes:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Consumes
produces:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Produces
intent:
anyOf:
- type: string
- type: 'null'
title: Intent
type: object
required:
- name
- tasks
title: CreateOperatorRequest
UpdateOperatorRequest:
properties:
name:
type: string
title: Name
filters:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
title: Filters
tasks:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
title: Tasks
params:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Params
template:
anyOf:
- type: string
- type: 'null'
title: Template
consumes:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Consumes
produces:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Produces
intent:
anyOf:
- type: string
- type: 'null'
title: Intent
type: object
required:
- name
title: UpdateOperatorRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
HTTPBasic:
type: http
scheme: basic