Skip to content

Kestra API

Kestra API

API endpoints for Kestra workflow integration.

Base URL

http://localhost:3001/api/kestra

Trigger Flow

Trigger a Kestra workflow.

Request

POST /api/kestra/trigger/:flowId
Content-Type: application/json
{
"inputs": {
"matchId": "AR-2024-0142"
}
}

Response

{
"executionId": "exec-123",
"status": "running"
}

List Executions

Get list of Kestra workflow executions.

Request

GET /api/kestra/executions

Query Parameters

  • limit - Limit number of results
  • offset - Offset for pagination

Response

[
{
"id": "exec-123",
"flowId": "match-orchestration",
"status": "success",
"startedAt": "2024-12-14T10:00:00Z",
"completedAt": "2024-12-14T10:05:00Z"
}
]

Get Execution

Get details for a specific execution.

Request

GET /api/kestra/executions/:id

Response

{
"id": "exec-123",
"flowId": "match-orchestration",
"status": "success",
"startedAt": "2024-12-14T10:00:00Z",
"completedAt": "2024-12-14T10:05:00Z",
"outputs": {
"matchId": "AR-2024-0142",
"score": {
"red": 75,
"blue": 85
}
}
}

Next Steps