> Documentation index for agents: https://docs.rocketride.ai/llms.txt

# webhook

A RocketRide source-node directory offering raw HTTP intake, browser chat and upload interfaces, and a tool-only endpoint; choose the service that matches how a client should enter the pipeline.

## What it does

The directory provides four endpoint services that share a long-running, engine-provided web server: Webhook, Chat, Dropper, and Tools. Choose **Webhook** for programmatic HTTP intake, **Chat** for browser-submitted questions, **Dropper** for browser file uploads, or **Tools** when an application needs to call connected tools without adding an agent or data lane. Each service is a source, so it starts work rather than consuming a preceding pipeline lane.

## Connections

### Tools (`tools://`)

| Connection | Required | Description |
| --- | --- | --- |
| `tool` | no | Tool nodes hosted by this endpoint through the control-plane invoke channel. |

The Tools service has no data outputs. It keeps the endpoint alive so a client can reach the connected tools directly.

## Lanes

| Lane in | Lane out | Description |
| --- | --- | --- |
| `_source` | `questions` | **Chat** emits each browser-submitted message as a question. |
| `_source` | `tags` | **Dropper** emits uploaded files as tagged data. |
| `_source` | — | **Tools** is an invoke host and emits no data lane. |
| `_source` | `tags` | **Webhook** can emit tagged input. |
| `_source` | `text` | **Webhook** can emit text input. |
| `_source` | `json` | **Webhook** can emit JSON input. |
| `_source` | `audio` | **Webhook** can emit audio input. |
| `_source` | `video` | **Webhook** can emit video input. |
| `_source` | `image` | **Webhook** can emit image input. |
| `_source` | `questions` | **Webhook** can emit question input. |

## Configuration

These services expose no node-specific settings beyond the standard source properties. Select the service whose interaction model fits the caller, then wire its declared output lane to the downstream node that handles that data type.

### Endpoint service

Use **Webhook** when another system can send an HTTP request, **Chat** when people should enter questions in a web UI, and **Dropper** when people should upload files in a web UI. Use **Tools** only to host invoke-connected tool nodes for direct client calls: it intentionally has neither a user-facing URL nor a data lane.

## Authentication

On startup, Webhook, Chat, and Dropper publish an interface URL plus a public authorization key and private token in the monitor information. The Chat and Dropper button URLs include the public authorization key as the `auth` query parameter; Tools does not publish a user-facing URL. Treat the private token as a secret and restrict access to monitor information that contains it.

## Notes

### Shared server lifecycle

The source observes engine cancellation on explicit termination and idle-TTL expiry, so the task can run connected nodes' `endGlobal()` cleanup even when no request has arrived. Cleanup must finish within the supervisor's graceful-stop deadline; forced termination cannot guarantee resource release.

The endpoint registers its target with the shared web server initialized by `ai.node` and waits until shutdown. It does not create a server itself. If that shared server is unavailable, startup raises an explanatory error; run these services through the RocketRide pipeline process that provides it. The published interface is reachable only where deployment networking, firewalls, and reverse proxies permit access.

<!-- ROCKETRIDE:GENERATED:PARAMS START -->
<!-- Generated by nodes:docs-generate. Do not edit by hand. -->

## Schema

### Chat (`services.chat.json`)

| Field | Type | Description | Default |
|---|---|---|---|
| `Pipe.source.parameters` |  |  |  |

### Dropper (`services.dropper.json`)

| Field | Type | Description | Default |
|---|---|---|---|
| `Pipe.source.parameters` |  |  |  |

### Tools (`services.tools.json`)

_No configuration fields._

### Webhook (`services.webhook.json`)

_No configuration fields._

## Source

[<svg viewBox="0 0 16 16" width="15" height="15" fill="currentColor" aria-hidden="true" style="vertical-align:-0.15em;margin-right:0.35em"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg> View source](https://github.com/rocketride-org/rocketride-server/tree/develop/nodes/src/nodes/webhook)
<!-- ROCKETRIDE:GENERATED:PARAMS END -->
