Create a log entry for a specific execution (admin only).
Authentication: JWT token required Authorization: Admin level access required (ADMIN or SUPERADMIN) Purpose: Manually add log entries for debugging, monitoring, or audit purposes
Path Parameters:
- execution: Execution ID (UUID format)
Request Schema:
{
"level": "INFO",
"message": "Custom log message for execution monitoring",
"details": {
"component": "manual_logging",
"admin_action": true,
"timestamp": "2025-01-15T10:30:00Z"
}
}
Request Fields:
- level: Log level - "DEBUG", "INFO", "WARNING", "ERROR" (required)
- message: Log message content (required, max 1000 characters)
- details: Additional structured data (optional JSON object)
- timestamp: Log timestamp (optional, defaults to current time)
Success Response Schema:
{
"data": {
"id": "log-789",
"execution_id": "abc123-def456",
"timestamp": "2025-01-15T10:30:00Z",
"level": "INFO",
"message": "Custom log message for execution monitoring",
"details": {
"component": "manual_logging",
"admin_action": true,
"created_by": "admin-user-123"
}
}
}
Use Cases:
- Add administrative notes to execution logs
- Record manual interventions or troubleshooting steps
- Supplement automated logs with human observations
- Document resolution of execution issues
Log Integration:
- Manual logs appear alongside automated execution logs
- Preserved in execution log history
- Included in log exports and monitoring dashboards
- Tagged with creating admin user information
Error Responses:
- 401 Unauthorized: JWT token required
- 403 Forbidden: Admin access required
- 404 Not Found: Execution does not exist
- 422 Unprocessable Entity: Invalid request data or validation failed
- 500 Internal Server Error: Log creation failed
post/api/v1/execution/{execution}/log
Path parameters
executionstring required
Path parameter: execution
Request body
object required
Response
Success
object required
Changes
No recorded changes to this endpoint across all 1 revision of this API.