Skip to main content
POST
/
api
/
v1
/
jobs
/
webhook
/
{webhook_path}
Trigger Webhook
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/jobs/webhook/{webhook_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "parameters": {},
  "config_override": {},
  "metadata": {}
}
'
{
  "job_id": "<string>",
  "execution_id": "<string>",
  "workflow_id": "<string>",
  "status": "<string>",
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Headers

​
x-webhook-signature
string | null

Path Parameters

​
webhook_path
string
required

Body

application/json

Schema for webhook trigger payload

​
parameters
Parameters · object

Parameters to substitute in prompt template

​
config_override
Config Override · object

Optional config overrides for this execution

​
metadata
Metadata · object

Additional metadata for this webhook trigger

Response

Successful Response

Schema for job trigger response

​
job_id
string
required
​
execution_id
string
required
​
workflow_id
string
required
​
status
string
required
​
message
string
required