Skip to content
HookNexus

Request management API

Use these endpoints to work with stored webhook requests (rows in webhook_logs).

Base URL: https://api.hooknexus.com

Get request detail

GET /api/requests/:id

Returns one log entry by its UUID. Expired or hidden logs (outside retention) may return 404.

Path parameters

ParameterDescription
idWebhook log ID (returned in Webhook receiving as id)

Example response (200 OK)

{
  "id": "log-uuid-1",
  "endpoint_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "method": "POST",
  "path": "/h/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "headers": {
    "content-type": "application/json",
    "x-forwarded-for": "203.0.113.10"
  },
  "query": {
    "sig": "abc"
  },
  "body": "{\"hello\":\"world\"}",
  "content_type": "application/json",
  "ip": "203.0.113.10",
  "user_agent": "curl/8.0",
  "size": 18,
  "created_at": "2026-03-23T12:00:00.000Z"
}

Delete a single request

DELETE /api/requests/:id

Permanently removes one log row.

Example response (200 OK)

{
  "success": true
}

Batch delete requests

DELETE /api/requests

Deletes multiple log rows in one call. Send a JSON array of log IDs.

Body parameters (JSON)

ParameterTypeRequiredDescription
idsstring[]YesNon-empty list of webhook log UUIDs to delete

Example request

DELETE /api/requests HTTP/1.1
Host: api.hooknexus.com
Content-Type: application/json


{
  "ids": [
    "log-uuid-1",
    "log-uuid-2"
  ]
}

Example response (200 OK)

{
  "success": true,
  "deleted": 2
}

Error response (400 Bad Request)

{
  "error": "No IDs provided"
}