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

Hour One webhook API

The webhook API from Hour One — 5 operation(s) for webhook.

Hour One webhook API is one of 6 APIs that Hour One publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 8 operations across 5 paths, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, /api/v1.

8 operations 5 paths 7 schemas 1 DELETE2 GET1 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.makereals.com/api/v1
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Hour One webhook API declares 2 security schemes for authenticating requests. An API key is passed in the header as api-key (APIKeyHeader). It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 1 DELETE, 2 GET, 1 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

webhook 8
GET
/webhooks
Get Webhooks
get_webhooks_webhooks_get → 200
POST
/webhooks
Create Webhook
create_webhook_webhooks_post body → 201422
GET
/webhooks/{webhook_id}
Get Webhook
get_webhook_webhooks__webhook_id__get 1 param → 200422
PUT
/webhooks/{webhook_id}
Update Webhook
update_webhook_webhooks__webhook_id__put 1 param body → 200422
DELETE
/webhooks/{webhook_id}
Delete Webhook
delete_webhook_webhooks__webhook_id__delete 1 param → 204422
PUT
/webhooks/{webhook_id}/secret
Regenerate Webhook Secret
regenerate_webhook_secret_webhooks__webhook_id__secret_put 1 param → 200422
PUT
/webhooks/{webhook_id}/pause
Toggle Pause State
toggle_pause_state_webhooks__webhook_id__pause_put 1 param → 200422
PUT
/webhooks/{webhook_id}/toggle-status
Toggle Active State
toggle_active_state_webhooks__webhook_id__toggle_status_put 1 param → 200422

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are WebhookResponse (9 properties), WebhookRequest (4 properties), UpdateWebhookRequest (4 properties), ValidationError (3 properties). Each schema is shown below with its type and property counts.

WebhookResponse
object
9 properties 3 required
WebhookStatusOptions
string
An enumeration.
EventName
string
An enumeration.
ValidationError
object
3 properties 3 required
UpdateWebhookRequest
object
4 properties 2 required
WebhookRequest
object
4 properties 3 required
HTTPValidationError
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hour-one-webhook-api-openapi.yml Raw ↑

Other APIs Hour One publishes across the network.

Hour One general API
Hour One keys API
Hour One playground API
Hour One videos API
Hour One voice-preview API