---
title: "Send Log Lines"
method: POST
path: "/logs/ingest"
tags: ["Ingestion"]
---

# Send Log Lines

`POST /logs/ingest`

Use this method to send logs to a logging instance.

### Authentication
You can find instructions on authentication [here](/log-analysis-api/ref#authentication).  Ingestion is
similar to the other APIs, but instead of `servicekey` you will use `apikey` if
you are using the header style authentication.

### Metadata
Meta is a field reserved for custom information associated with a log line. To add 
metadata to an API call, specify the `meta` field under the lines object. Metadata can be
viewed inside that line's context

WARNING: If inconsistent value types are
used, that line's metadata, will not be parsed. For example, if a line is passed
with a meta object, such as `meta.myfield` of type String, any subsequent lines
with `meta.myfield` must have a String as the value type for `meta.myfield`.
> Please be aware of [service limits](https://docs.mezmo.com/docs/Mezmo-ingestion-service-limits)
> on this endpoint

## Query parameters

- `hostname` string, required
- `mac` string — The network mac address of the host computer.
- `ip` string — The local IP address of the host computer (ipv4 or ipv6)
- `now` string
- `tags` string

## Request body

- Ingestlines
  - `lines` object[]
    - `timestamp` string — UNIX timestamp, including milliseconds, when the log entry was recorded.
    - `line` string, required — Text of the log line.
    - `app` string — Name of the application that generates the log line.
    - `level` string — Set a value for the level. For example, sample values for this parameter are INFO, WARNING, ERROR.
    - `meta` string — This field is reserved for custom information that is associated with a log line. To add metadata to an API call, specify the meta field under the lines object. Metadata can be viewed inside that line's context.

## Response `200`

OK

- object

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/mezmo/apis/pipeline-api.md) · [All operations](https://skmtc.net/mezmo/apis/pipeline-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mezmo/pipeline-api/revisions/fb2535545d90/schema)