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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/skavio-eu:skavio-eu-operational-notifications-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Skavio Processing Operational notifications API
  description: Company scoped file, document and audio processing. Bearer API key or same-origin web session. Idempotency-Key required for jobs, bulk pause/cancel, workflow runs and pipeline mutations. Notifications are disabled by default; updating company notification settings requires an administrator web session. Workflow resume with a changed cap or key requires an administrator session.
  version: 1.9.0
servers:
- url: https://getskavio.com
security:
- BearerKey: []
- WebSession: []
tags:
- name: Operational notifications
paths:
  /v1/notifications/settings:
    get:
      tags:
      - Operational notifications
      summary: Read opt-in notification configuration
      operationId: settings_v1_notifications_settings_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '401':
          description: Invalid authentication
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '403':
          description: Insufficient permission
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '404':
          description: Object not found in company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '409':
          description: State/idempotency conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '413':
          description: Request too large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '422':
          description: Invalid request or source
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '429':
          description: Rate or queue limit
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '503':
          description: Processing unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '410':
          description: Source or result expired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '502':
          description: Request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '504':
          description: Request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
    put:
      tags:
      - Operational notifications
      summary: Administrator opt-in for low-credit and processing state notifications
      operationId: update_v1_notifications_settings_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NotificationSpec'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '401':
          description: Invalid authentication
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '403':
          description: Insufficient permission
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '404':
          description: Object not found in company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '409':
          description: State/idempotency conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '413':
          description: Request too large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '429':
          description: Rate or queue limit
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '503':
          description: Processing unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '410':
          description: Source or result expired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '502':
          description: Request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '504':
          description: Request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
      security:
      - WebSession: []
      x-skavio-company-admin-required: true
  /v1/notifications:
    get:
      tags:
      - Operational notifications
      summary: Bounded company notification delivery history
      operationId: listing_v1_notifications_get
      parameters:
      - name: before
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Before
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '401':
          description: Invalid authentication
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '403':
          description: Insufficient permission
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '404':
          description: Object not found in company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '409':
          description: State/idempotency conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '413':
          description: Request too large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '429':
          description: Rate or queue limit
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '503':
          description: Processing unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '410':
          description: Source or result expired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '502':
          description: Request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
        '504':
          description: Request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIError'
          headers:
            X-Request-Id:
              schema:
                type: string
              description: Server-generated correlation ID; provide to support.
components:
  schemas:
    NotificationSpec:
      properties:
        enabled:
          type: boolean
          title: Enabled
          default: false
        webhook_id:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Webhook Id
        email:
          type: boolean
          title: Email
          default: false
        language:
          type: string
          pattern: ^(cs|de|en)$
          title: Language
          default: en
      additionalProperties: false
      type: object
      title: NotificationSpec
    APIError:
      type: object
      properties:
        detail: {}
        error_code:
          type: string
        request_id:
          type: string
        retryable:
          type: boolean
      required:
      - detail
      - error_code
      - request_id
      - retryable
  securitySchemes:
    BearerKey:
      type: http
      scheme: bearer
      description: Company key created in the dashboard; read/write scopes.
    WebSession:
      type: apiKey
      in: cookie
      name: skavio_web_account
      description: Interactive same-origin company session for administrative operations.