ImageStep

ImageStep Webhooks API

Register URLs to receive job events instead of polling, and read back what was delivered. At most 10 endpoints per account. Every delivery is signed with the endpoint's secret and retried until your receiver answers `2xx` or 24 hours have passed; the events, their bodies and how to verify a signature are on /docs/webhooks.

GitHub OpenAPI

Operations 8

GET /api/v1/webhook-endpoints/{id} Get one webhook endpoint #
PUT /api/v1/webhook-endpoints/{id} Update a webhook endpoint #
DELETE /api/v1/webhook-endpoints/{id} Delete a webhook endpoint #
GET /api/v1/webhook-endpoints List webhook endpoints #
POST /api/v1/webhook-endpoints Register a webhook endpoint #
POST /api/v1/webhook-endpoints/{id}/test Send a test delivery #
POST /api/v1/webhook-endpoints/{id}/rotate-secret Rotate the signing secret #
GET /api/v1/webhook-endpoints/{id}/deliveries Recent deliveries to an endpoint #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/imagestep-dev/openapi/imagestep-dev-webhooks-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/imagestep-dev/json-schema/imagestep-dev-job-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/imagestep-dev/json-schema/imagestep-dev-preset-data-schema.json
📊
JSONSchema
https://artifacts.apis.io/imagestep-dev/json-schema/imagestep-dev-template-data-schema.json
📊
JSONSchema
https://artifacts.apis.io/imagestep-dev/json-schema/imagestep-dev-endpoint-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/imagestep-dev/json-schema/imagestep-dev-finish-upload-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/imagestep-dev/json-schema/imagestep-dev-from-url-request-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/imagestep-dev:imagestep-dev-webhooks-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.

GitHub Google LinkedIn

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

OpenAPI Specification

imagestep-dev-webhooks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ImageStep Webhooks API
  description: 'The image step for your automations. Store images as assets, run an op or a preset on them as a job — priced first with `?dryRun=true`, then read, waited on or delivered to a webhook — or transform one image synchronously while you wait. Send `Authorization: ApiKey `; the op catalogue (`/api/v1/ops`) needs no credential.


    **Idempotency:** Endpoints that accept an `Idempotency-Key` header support optional deduplication. Supply a unique key (e.g. a UUID) per logical request. Repeating the same key with the same body replays the stored response (`Idempotency-Replayed: true`) without re-running anything; repeating it with a different body is a 409 `idempotency_key_reuse`. Omitting the header processes the request normally. Keys are retained for 24 hours.


    **Errors** all share one shape: `{"error": {"code", "message", "retryable", "param", "details", "requestId"}}`. Branch on `code`, and let `retryable` — not the status code — decide whether to come back.


    **Rate limits** are published on every response as `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds). A 429 adds `Retry-After`.


    **A paged list** takes `page` (from 0) and `perPage`, and every page answers `meta.nextCursor`; send it back as `cursor` to read on without counting.


    **Every response carries `X-Request-Id`** — yours if you sent one, ours otherwise — and a failure repeats it as `error.requestId`. It is what finds the request in our logs.


    The error-code table, idempotency, limits and pagination are at https://imagestep.dev/docs/errors; the webhook events at https://imagestep.dev/docs/webhooks; what may change inside v1, and the changelog, at https://imagestep.dev/docs/changelog.'
  contact:
    name: ImageStep Team
    url: https://imagestep.dev/support
  license:
    name: Proprietary
    url: https://imagestep.dev/terms
  version: v1
servers:
- url: https://api.imagestep.dev
  description: Production server
tags:


# --- truncated at 32 KB (60 KB total) ---
# Full source: https://artifacts.apis.io/imagestep-dev/openapi/imagestep-dev-webhooks-api-openapi.yml