---
title: "Incoming Webhook Wait"
method: POST
path: "/webhooks/{workflow_id}/{secret}/wait"
tags: ["public"]
---

# Incoming Webhook Wait

`POST /webhooks/{workflow_id}/{secret}/wait`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/webhooks/{workflow_id}/{secret}/wait`
- Auth: none declared

Webhook endpoint to trigger a workflow.

This is an external facing endpoint is used to trigger a workflow by sending a webhook request.
The workflow is identified by the `path` parameter, which is equivalent to the workflow id.

## Path parameters

- `secret` string, required
- `workflow_id` union, required
  - string
  - string

## Query parameters

- `unwrap` boolean: Return the workflow result directly as the response body, without the `{kind, value}` envelope. Requires the result to fit inline. If the result was externalized, returns 413 with the download envelope in `detail`.

## Headers

- `content-type` string, nullable

## Response `200`

Successful Response

- union
  - WebhookStoredObjectInlineResponse
    - `kind` 'value', required
    - `value` unknown, required
  - WebhookStoredObjectDownloadResponse
    - `kind` 'download_file' | 'download_export', required
    - `download_url` string, required
    - `expires_in_seconds` integer, required
    - `content_type` string, required
    - `size_bytes` integer, required

## Other responses

- `413`: Unwrapped workflow result exceeded inline response limits. Use `detail.download_url` to fetch the externalized result.
- `422`: Invalid request parameters or a user-owned workflow failure.

---

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