Skip to main content

# Insert A Single Line (LCC.web_file.insert_line)

## Signature​

    ok, err = LCC.web_file.insert_line(path, line_number, line, timeout?)

## Parameters​

- path
  String. File path.
- line_number
  Number. Reference line index for insertion. Positive numbers start at `1` and insert before that line; negative values count from the end, `0` appends after the last line, and `-1` inserts before the last line.
- line
  String. Text to insert.
- timeout
  Number, optional. Request timeout in seconds, default `60`.

## Returns​

- ok
  Boolean. `true` on success, `false` on failure.
- err
  String or `nil`. Error description when the operation fails.

## Notes​

> Convenience wrapper around `insert_lines` for a single entry.
> Inserts one line before the specified line index; see the parameter description above for line-number rules.
> Useful for adding headers or log entries at specific spots.

## Example​

    local ok, err = LCC.web_file.insert_line("/config/list.txt", 1, "Header")
    if not ok then
        error(err)
    end