🚫
Internal use only!
Events are a way to trigger actions in response to certain conditions or changes in the system. They are typically used to notify other parts of the system (as well as plugins) about important occurrences, such as changes in data, agent actions, or system events.
PLUGIN_INSTALLED
This event is triggered when a plugin is installed. It can be used to perform actions or notify other parts of the system about the installation of a plugin (or the creation of a plugin instance).
{
"name": "PLUGIN_INSTALLED",
"instance": {
"id": "6823341466b90fb047739892",
"agentId": "6819a0e484df0fc342cea506",
"createdAt": "2025-05-13T11:59:16.426Z",
"entityId": "6819a0e484df0fc342cea506",
"entityType": "AGENT",
"eventDispatchCondition": null,
"eventDispatchMode": "SYNC",
"events": [ "AGENT_MESSAGE_RECEIVED" ],
"inputs": { "apiKey": "sk-proj-your-api-key" },
"name": "GPT-4o Message Processor",
"orgId": "6816330b6f46b5afc080fbf7",
"pluginId": "681f23cc38780a323859233f",
"scopes": [ "AGENT_MESSAGE_WRITE" ],
"updatedAt": "2025-05-13T11:59:16.426Z"
},
"token": {
"id": "6823341466b90fb047739893",
"createdAt": "2025-05-13T11:59:16.777Z",
"entityId": "6823341466b90fb047739892",
"entityType": "PLUGIN_INSTANCE",
"expires": null,
"name": "Token for plugin instance: GPT-4o Message Processor (#6823341466b90fb047739892)",
"orgId": "6816330b6f46b5afc080fbf7",
"pluginInstanceId": "6823341466b90fb047739892",
"scopes": [ "AGENT_MESSAGE_WRITE" ],
"updatedAt": "2025-05-13T11:59:16.777Z",
"userId": null,
"token": "inst-7e616ab3e94888b1c26c1c4c.62e2001f13175e86ee7e105542f8b34c.0ae65a21c440b266c3b9a1eec9c880c2.3046eafa6e7746b3a3f0fa00289610db91d4a75bf9b65baa"
}
}WEBHOOK_CHALLENGE
This event is triggered when a webhook is being verified. To be successfully verified, the webhook must respond with a JSON object containing the challenge string sent by the system.
{
"name": "WEBHOOK_CHALLENGE",
"challenge": "3v4suclng21"
}