Sign in

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