skavio-eu

skavio-eu Webhooks API

The Webhooks API from skavio-eu — 4 operation(s) for webhooks.

GitHub OpenAPI

Operations 5

GET /v1/webhooks/deliveries Company delivery history for jobs, batches and bulks #
POST /v1/webhooks/deliveries/{kind}/{delivery_id}/replay Replay an exhausted delivery with the original event ID and frozen body #
GET /v1/webhooks List webhook URLs and delivery history #
POST /v1/webhooks Register a signed completion callback #
DELETE /v1/webhooks/{webhook_id} Disable a webhook and future deliveries #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/skavio-eu/openapi/skavio-eu-webhooks-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-bulk-spec-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-batch-spec-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-storage-object-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-batch-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-spec-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-pipeline-run-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-event-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-invoice-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-invoice-create-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-me-schema.json
📊
JSONSchema
https://artifacts.apis.io/skavio-eu/json-schema/skavio-eu-request-create-schema.json

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/skavio-eu:skavio-eu-webhooks-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

skavio-eu-webhooks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Skavio Processing Webhooks 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: Webhooks
paths:
  /v1/webhooks/deliveries:
    get:
      tags:
      - Webhooks
      summary: Company delivery history for jobs, batches and bulks
      operationId: deliveries_v1_webhooks_deliveries_get
      parameters:
      - name: kind
        in: query
        required: false
        schema:
          enum:
          - job
          - batch
          - bulk
          type: string
          default: job
          title: Kind
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 100
          title: Limit
      - name: before
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Before
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeliveryHistory'
          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/webhooks/deliveries/{kind}/{delivery_id}/replay:
    post:
      tags:
      - Webhooks
      summary: Replay an exhausted delivery with the original event ID and frozen body
      operationId: replay_v1_webhooks_deliveries__kind___delivery_id__replay_post
      parameters:
      - name: kind
        in: path
        required: true
        schema:
          enum:
          - job
          - batch
          - bulk
          type: string
          title: Kind
      - name: delivery_id
        in: path
        required: true
        schema:
          type: string
          title: Delivery Id
      - name: Idempotency-Key
        in: header
        required: true
        schema:
          type: string
          minLength: 8
          maxLength: 128
          pattern: ^[A-Za-z0-9_.:-]+$
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeliveryReplay'
          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/webhooks:
    get:
      tags:
      - Webhooks
      summary: List webhook URLs and delivery history
      operationId: webhooks_v1_webhooks_get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  webhooks:
                    type: array
                    items:
                      $ref: '#/components/schemas/Webhook'
                  deliveries:
                    type: array
                    items:
                      $ref: '#/components/schemas/Delivery'
                  batch_deliveries:
                    type: array
                    items:
                      $ref: '#/components/schemas/BatchDelivery'
                required: []
          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.
      security:
      - WebSession: []
      x-skavio-company-admin-required: true
    post:
      tags:
      - Webhooks
      summary: Register a signed completion callback
      operationId: create_v1_webhooks_post
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  url:
                    type: string
                  secret:
                    type: string
                required:
                - id
                - url
                - secret
          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.
      security:
      - WebSession: []
      x-skavio-company-admin-required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  maxLength: 2000
              required:
              - url
  /v1/webhooks/{webhook_id}:
    delete:
      tags:
      - Webhooks
      summary: Disable a webhook and future deliveries
      operationId: delete_v1_webhooks__webhook_id__delete
      parameters:
      - name: webhook_id
        in: path
        required: true
        schema:
          type: string
          title: Webhook Id
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OK'
          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
components:
  schemas:
    BatchDelivery:
      type: object
      properties:
        id:
          type: string
        batch_id:
          type: string
        status:
          type: string
          enum:
          - pending
          - delivered
          - failed
          - disabled
        attempts:
          type: integer
        last_error:
          anyOf:
          - type: string
          - type: 'null'
      required: []
    Webhook:
      type: object
      properties:
        id:
          type: string
        url:
          type: string
        active:
          type: integer
        created_at:
          type: string
      required: []
    APIError:
      type: object
      properties:
        detail: {}
        error_code:
          type: string
        request_id:
          type: string
        retryable:
          type: boolean
      required:
      - detail
      - error_code
      - request_id
      - retryable
    Delivery:
      type: object
      properties:
        id:
          type: string
        job_id:
          type: string
        status:
          type: string
          enum:
          - pending
          - delivered
          - failed
          - disabled
        attempts:
          type: integer
        last_error:
          anyOf:
          - type: string
          - type: 'null'
      required: []
    DeliveryHistory:
      type: object
      properties:
        kind:
          enum:
          - job
          - batch
          - bulk
        deliveries:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              parent_id:
                type: string
              status:
                type: string
              attempts:
                type: integer
              last_error:
                anyOf:
                - type: string
                - type: 'null'
              next_attempt:
                type: number
              created_at:
                type: string
            required: []
        next_cursor:
          anyOf:
          - type: string
          - type: 'null'
      required: []
    OK:
      type: object
      properties:
        ok:
          type: boolean
        accounting_retained:
          type: boolean
      required:
      - ok
    DeliveryReplay:
      type: object
      properties:
        ok:
          type: boolean
        event_id:
          type: string
        replayed:
          type: boolean
      required:
      - ok
      - event_id
      - replayed
  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.