---
title: "Inbound Event Webhook"
method: POST
path: "/v1/webhooks/inbound/{capability}"
tags: ["webhooks"]
---

# Inbound Event Webhook

`POST /v1/webhooks/inbound/{capability}`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/webhooks/inbound/{capability}`
- Auth: none declared

Admit one signed event from a workspace's own system, or refuse it.

A followed event commits before its critical broker publish. A broker failure therefore leaves
a durable pending row and returns 503. The sender's retry reaches the tenant/source/event
conflict and does not publish a second task.

## Path parameters

- `capability` string, required

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `400`: The JSON payload is invalid or exceeds the body-size limit.
- `401`: The capability or event-source signature is invalid, or the workspace it names has been deleted. Do not retry this delivery.
- `422`: Validation Error
- `503`: The event source has no verifier or usable signing secret, the workspace it names is suspended or cancelled, or the task broker is unavailable. Retry: the endpoint is real and may accept this event later.

---

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