---
title: "Create a log entry"
method: POST
path: "/logs"
tags: ["logs"]
---

# Create a log entry

`POST /logs`

Accepts a JSON log entry and stores it in BadgerDB

## Request body

- TypesLog
  - `driver` string — Driver is the name of the driver that generated the log. This helps in identifying which component of the system produced the log.
  - `message` string — Message is the actual log message. This contains the information or error details that you want to record.
  - `pipeline` string — Pipeline is the name of the pipeline associated with the log. This allows you to trace logs back to specific pipelines.
  - `runid` string — RunID is a unique identifier for the workflow run. This allows you to group logs by specific runs of your pipelines.
  - `timestamp` string — Timestamp is the time when the log was created. This is useful for ordering logs and understanding the sequence of events.

## Response `201`

Log created

- string

## Other responses

- `400` — Bad request - Invalid payload
- `500` — Internal server error

## Changes

- **2025-09-28** `ef1146f3d831` — 1 info
  - endpoint added
- **2025-08-17** `2bbb58594c86` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/open-ug/apis/conveyor-ci-api/changes/logs/post.md)

---

[API](https://skmtc.dev/open-ug/apis/conveyor-ci-api.md) · [All operations](https://skmtc.dev/open-ug/apis/conveyor-ci-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/open-ug/conveyor-ci-api/revisions/4ad35de52cbb/schema)