---
title: "Receive Webhook"
method: POST
path: "/api/webhooks/{agent_id}"
tags: ["webhooks"]
---

# Receive Webhook

`POST /api/webhooks/{agent_id}`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/webhooks/{agent_id}`
- Auth: none declared

Accept a payload for an agent and deliver it in the background.

Returns the agent record under auth modes ``off``/``warn`` (legacy shape;
``status`` reflects the agent's state at accept time, the wake itself
happens in the background) and ``{"status": "accepted"}`` under
``require``.

## Path parameters

- `agent_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/maritime/apis/maritime-api.md) - [All operations](https://skmtc.dev/maritime/apis/maritime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maritime/apis/maritime-api/revisions/acd712090ad6?raw)