Busabase
OpenAPI Reference

Webhooks

Webhook registration and delivery management.

GET
/api/v1/webhooks

Response Body

application/json

curl -X GET "https://example.com/api/v1/webhooks"
[  {    "id": "string",    "spaceId": "string",    "baseId": "string",    "name": "string",    "eventType": "record.created",    "enabled": true,    "createdBy": "string",    "createdAt": "string",    "updatedAt": "string",    "lastTriggeredAt": "string",    "lastStatus": "success",    "actionKind": "webhook",    "config": {      "targetUrl": "http://example.com",      "hasSecret": true,      "headers": {        "property1": "string",        "property2": "string"      }    }  }]
POST
/api/v1/webhooks

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/api/v1/webhooks" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "eventType": "record.created",    "actionKind": "webhook",    "config": {      "targetUrl": "http://example.com"    }  }'
{  "id": "string",  "spaceId": "string",  "baseId": "string",  "name": "string",  "eventType": "record.created",  "enabled": true,  "createdBy": "string",  "createdAt": "string",  "updatedAt": "string",  "lastTriggeredAt": "string",  "lastStatus": "success",  "actionKind": "webhook",  "config": {    "targetUrl": "http://example.com",    "hasSecret": true,    "headers": {      "property1": "string",      "property2": "string"    }  }}
GET
/api/v1/webhooks/{id}

Path Parameters

id*string

Response Body

application/json

curl -X GET "https://example.com/api/v1/webhooks/string"
{  "id": "string",  "spaceId": "string",  "baseId": "string",  "name": "string",  "eventType": "record.created",  "enabled": true,  "createdBy": "string",  "createdAt": "string",  "updatedAt": "string",  "lastTriggeredAt": "string",  "lastStatus": "success",  "actionKind": "webhook",  "config": {    "targetUrl": "http://example.com",    "hasSecret": true,    "headers": {      "property1": "string",      "property2": "string"    }  }}
DELETE
/api/v1/webhooks/{id}

Path Parameters

id*string

Response Body

application/json

curl -X DELETE "https://example.com/api/v1/webhooks/string"
{  "success": true}
PUT
/api/v1/webhooks/{id}

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PUT "https://example.com/api/v1/webhooks/string" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "eventType": "record.created",    "actionKind": "webhook",    "config": {      "targetUrl": "http://example.com"    }  }'
{  "id": "string",  "spaceId": "string",  "baseId": "string",  "name": "string",  "eventType": "record.created",  "enabled": true,  "createdBy": "string",  "createdAt": "string",  "updatedAt": "string",  "lastTriggeredAt": "string",  "lastStatus": "success",  "actionKind": "webhook",  "config": {    "targetUrl": "http://example.com",    "hasSecret": true,    "headers": {      "property1": "string",      "property2": "string"    }  }}
GET
/api/v1/webhooks/{ruleId}/deliveries

Path Parameters

ruleId*string

Query Parameters

limit?integer

Delivery attempts to return, newest first.

Range1 <= value <= 100
Default20

Response Body

application/json

curl -X GET "https://example.com/api/v1/webhooks/string/deliveries"
[  {    "id": "string",    "ruleId": "string",    "eventType": "record.created",    "status": "success",    "httpStatus": 0,    "detail": "string",    "durationMs": 0,    "createdAt": "string"  }]
POST
/api/v1/webhooks/{id}/test-fire

Path Parameters

id*string

Response Body

application/json

curl -X POST "https://example.com/api/v1/webhooks/string/test-fire"
{  "id": "string",  "ruleId": "string",  "eventType": "record.created",  "status": "success",  "httpStatus": 0,  "detail": "string",  "durationMs": 0,  "createdAt": "string"}