---
title: "deliverWebhook"
---

> Documentation Index
> Fetch the complete documentation index at: https://agenthold.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# deliverWebhook

Path: agenthold API › auth-flow

`POST /hooks/{token}`

URL: `/api/v1/hooks/{token}`

Inbound webhook (no session or token: the URL is the secret). The
request body (up to 256 KiB) becomes part of the prompt, clearly marked
as untrusted. If the webhook has a signing secret, the signature
header must hold the HMAC-SHA256 of the body ("sha256=<hex>" or hex).

## Path parameters

- `token` (`deliverWebhook.path.token`; string, required)

## Request body (*/*)

Type: `string`

- format: `binary`

## Example request

```text
string
```

## Code samples

### cURL

```bash
curl --request POST \
  --url '<base-url>/api/v1/hooks/<token>' \
  --header 'Content-Type: */*' \
  --data-raw 'string'
```

### TypeScript

```typescript
const url = '<base-url>/api/v1/hooks/<token>';
const options = {
  method: 'POST',
  headers: {'Content-Type': '*/*'},
  body: 'string'
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "<base-url>/api/v1/hooks/<token>"

payload = "string"
headers = {"Content-Type": "*/*"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)
```

## Responses

### 202

The turn started.

### 401

Error.

#### Example

```json
{
  "error": "string"
}
```

- `error` (`deliverWebhook.response.401.error`; string, required)

### 404

Error.

#### Example

```json
{
  "error": "string"
}
```

- `error` (`deliverWebhook.response.404.error`; string, required)

### 409

Error.

#### Example

```json
{
  "error": "string"
}
```

- `error` (`deliverWebhook.response.409.error`; string, required)

### 413

Error.

#### Example

```json
{
  "error": "string"
}
```

- `error` (`deliverWebhook.response.413.error`; string, required)


Source: https://agenthold.dev/api/deliver-webhook/index.md