---
title: "TriggerAgentWebhook"
method: POST
path: "/v1/agents/webhook/trigger"
tags: ["textql.rpc.platform.AgentService"]
---

# TriggerAgentWebhook

`POST /v1/agents/webhook/trigger`

Trigger an agent run with a JSON webhook payload

## Headers

- `Connect-Protocol-Version` 1, required — Define the version of the Connect protocol
- `Connect-Timeout-Ms` number — Define the timeout, in ms

## Request body

- TextqlRpcPlatformTriggerAgentWebhookRequest
  - `triggerId` string, uuid, required — The webhook trigger ID for the agent.
  - `payload` object — JSON payload to pass to the agent as run context. Limited to 16KB after JSON serialization.

## Response `200`

Success

- TextqlRpcPlatformTriggerAgentWebhookResponse
  - `status` string — Queue status for the agent run.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/textql/apis/textql-rpc-platform.md) · [All operations](https://skmtc.net/textql/apis/textql-rpc-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textql/textql-rpc-platform/revisions/31ce2b0c4427/schema)