Files
pocketpaw/docs/api/get-webhooks.mdx
Rohit Kushwaha 4bb7313829 feat: move docs into monorepo, add deploy workflow
Consolidate documentation from the separate pocketpaw-web repo into the
main pocketpaw repo. This keeps docs and code in sync so PRs can update
both atomically.

- Remove docs/ from .gitignore
- Remove docs' own .git (was pocketpaw/pocketpaw-web)
- Add .github/workflows/deploy-docs.yml (builds from docs/ subdirectory)
- Track all 120+ MDX pages, config, landing page, and public assets

The separate pocketpaw-web repo can now be archived.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-13 13:12:04 +05:30

83 lines
2.4 KiB
Plaintext

---
title: List Webhooks
description: "List all configured inbound webhook slots in PocketPaw. Each webhook has a unique ID, auto-generated secret for authentication, and a URL for receiving external payloads."
api: GET /api/webhooks
baseUrl: http://localhost:8000
layout: '@/layouts/APIEndpointLayout.astro'
auth: bearer
section: API Reference
ogType: article
keywords: ["list webhooks", "inbound webhooks", "webhook slots"]
tags: ["api", "webhooks"]
---
## Overview
Returns all configured inbound webhook slots. Each webhook slot provides a unique URL and secret for receiving external payloads that are forwarded to the agent.
## Response
<ResponseField name="webhooks" type="array">
Array of webhook slot objects.
<ResponseField name="name" type="string">Webhook slot name (URL slug)</ResponseField>
<ResponseField name="description" type="string">Human-readable description</ResponseField>
<ResponseField name="secret" type="string">Webhook verification secret</ResponseField>
<ResponseField name="url" type="string">Full webhook URL</ResponseField>
</ResponseField>
<RequestExample>
<Tabs items={["cURL", "JavaScript", "Python"]}>
<Tab title="cURL">
```bash
curl -X GET "http://localhost:8000/api/webhooks" \
-H "Authorization: Bearer <token>"
```
</Tab>
<Tab title="JavaScript">
```javascript
const response = await fetch("http://localhost:8000/api/webhooks", {
headers: { "Authorization": "Bearer <token>" }
});
const data = await response.json();
console.log(data);
```
</Tab>
<Tab title="Python">
```python
import requests
response = requests.get(
"http://localhost:8000/api/webhooks",
headers={"Authorization": "Bearer <token>"}
)
print(response.json())
```
</Tab>
</Tabs>
</RequestExample>
<ResponseExample>
<Tabs items={["200"]}>
<Tab title="200">
```json
{
"webhooks": [
{
"name": "github-events",
"description": "GitHub repository webhooks",
"secret": "whsec_a1b2c3d4e5f6...",
"url": "http://localhost:8000/webhook/inbound/github-events"
},
{
"name": "stripe-payments",
"description": "Stripe payment notifications",
"secret": "whsec_x7y8z9w0...",
"url": "http://localhost:8000/webhook/inbound/stripe-payments"
}
]
}
```
</Tab>
</Tabs>
</ResponseExample>