Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kita Webhooks API

Register and manage HMAC-signed outbound webhooks.

Kita Webhooks API is one of 14 APIs that Kita publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Webhooks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 13 operations across 10 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://portal.usekita.com.

13 operations 10 paths 3 schemas 1 DELETE6 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v1
Base URL
https://portal.usekita.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Kita Webhooks API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Organization API key prefixed kitaprod, issued from the Kita dashboard at https://portal.usekita.com and sent as Authorization: Bearer .

Paths & Operations 13

Across 10 paths, the API surfaces 13 operations — 1 DELETE, 6 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Webhooks 13

Register and manage HMAC-signed outbound webhooks.

POST
/api/v1/webhooks
Register a webhook endpoint
createWebhook body → 200400401
GET
/api/v1/webhooks
List registered webhooks
listWebhooks → 200401
GET
/api/v1/webhooks/{webhookId}
Get a single webhook
getWebhook 1 param → 200401404
PATCH
/api/v1/webhooks/{webhookId}
Update a webhook
updateWebhook 1 param body → 200400401404
DELETE
/api/v1/webhooks/{webhookId}
Delete a webhook
deleteWebhook 1 param → 200401404
POST
/api/v1/webhooks/{webhookId}/test
Send a test delivery
testWebhook 1 param → 200401404
POST
/api/v1/webhooks/{webhookId}/rotate-secret
Rotate the signing secret
rotateWebhookSecret 1 param → 200401404
GET
/api/v1/webhooks/{webhookId}/secret
Retrieve the current signing secret
getWebhookSecret 1 param → 200401404
GET
/api/v1/webhooks/{webhookId}/deliveries
Get delivery history
listWebhookDeliveries 1 param → 200401404
GET
/api/v1/webhooks/stats
Get delivery aggregates
getWebhookStats → 200401
GET
/api/v1/webhooks/dlq
Get the dead-letter queue
getWebhookDeadLetterQueue → 200401
POST
/api/v1/webhooks/validate-url
Pre-flight check a candidate webhook URL
validateWebhookUrl body → 200400401
POST
/api/v1/webhooks/verify-signature
Verify a sample payload signature
verifyWebhookSignature body → 200400401

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are Webhook (4 properties), WebhookCreate (3 properties), Error (2 properties). Each schema is shown below with its type and property counts.

Error
object
2 properties
WebhookCreate
object
3 properties
Webhook
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kita-webhooks-api-openapi.yml Raw ↑

Other APIs Kita publishes across the network.

Kita Applications API
Kita Batch API
Kita Conversation API
Kita Credit API
Kita Documents API
Kita Exports API
Kita Folders API
Kita Memo API
Kita Processing API
Kita Results API
Kita Schemas API
Kita Transcripts API