Skip to main content
Trinity
API Reference/Webhook Triggers

Webhook Triggers

External event triggers and internal execution endpoints for programmatic agent invocation.

All endpoints require a JWT Bearer token unless noted. See Authentication for details. Full request/response schemas are available at http://localhost:8000/docs.

Internal Execution

No auth -- internal network only

EndpointMethodDescription
/api/internal/execute-taskPOSTExecute task (used by scheduler, supports async_mode)
/api/internal/decrypt-and-injectPOSTAuto-import credentials on agent startup

Process Triggers

EndpointMethodDescription
/api/processes/{id}/executePOSTStart process execution

Slack Events

EndpointMethodDescription
/api/public/slack/eventsPOSTSlack event receiver

Event Emission

EndpointMethodDescription
/api/eventsPOSTEmit event (triggers subscriptions)
/api/agents/{name}/emit-eventPOSTEmit for specific agent

The /api/internal/* endpoints are not authenticated and should only be accessible within the Docker network. They are used by the scheduler service and agent containers.

See Also

  • Authentication -- JWT token usage and login flow
  • Agents API -- Agent lifecycle and configuration endpoints
  • Chat API -- Chat, voice, and streaming endpoints
  • http://localhost:8000/docs -- Interactive Swagger documentation