Create a task execution record - SuperAI Flows

Create a task execution record

cURL

curl --request POST \
  --url https://flows.super.ai/api/task-executions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "flow_execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "<string>",
  "task_execution_idx": 1,
  "task_name": "<string>",
  "error": "<unknown>",
  "input": "<unknown>",
  "output": "<unknown>"
}
'```

### Example

```json
{
  "flow_execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "<string>",
  "task_execution_idx": 1,
  "task_name": "<string>",
  "created_at": "2025-01-23T10:30:00Z",
  "error": {
    "message": "Connection timeout after 30 seconds",
    "traceback": "Traceback (most recent call last):\n ...",
    "type": "ConnectionError"
  },
  "input": "<unknown>",
  "modified_by": "system",
  "output": {
    "email_id": "msg_123",
    "sent_at": "2025-01-23T10:30:00Z"
  },
  "updated_at": "2025-01-23T10:35:00Z"
}

Authorizations

• X-API-Key: string

  • Required in the header as: X-API-Key YOUR_API_KEY

• Authorization: string

  • Required in the header as: Bearer YOUR_ACCESS_TOKEN

Body

• flow_execution_id: string (required)

  • Example: "123e4567-e89b-12d3-a456-426614174000"

• status: string (required)

  • Valid values: 'queued', 'running', 'completed', 'failed', 'cancelled'.
  • Examples: "running", "completed", "failed"

• task_execution_idx: integer (required)

  • Examples: 0, 1, 2

• task_name: string (required)

  • Examples: "send_email", "process_data", "validate_input"

• error: any (only set when status is 'failed')

• input: any (optional)

• output: any (optional)

Response

• 201 Created: Task execution created successfully.