Skip to main content
POST
/
api
/
hooks
/
agents
/
{agentId}
/
webhooks
/
{webhookId}
Trigger Agent Webhook
curl --request POST \
  --url https://api.airtop.ai/api/hooks/agents/{agentId}/webhooks/{webhookId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "configVars": {
    "slackChannel": "#general"
  },
  "callbackConfig": {
    "url": "<string>",
    "headers": {}
  }
}
'
{
  "invocationId": "<string>"
}

Documentation Index

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

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

Authorizations

​
Authorization
string
header
required

Enter your API Key. You can generate one at https://portal.airtop.ai/api-keys.

Path Parameters

​
agentId
string<uuid>
required

The unique identifier of the agent

​
webhookId
string<uuid>
required

The unique identifier of the webhook

Body

application/json
​
configVars
object

Configuration variables for the agent session

Example:
{ "slackChannel": "#general" }
​
callbackConfig
object

Response

200 - application/json

Agent triggered successfully

​
invocationId
string

Unique identifier for the agent invocation