---
title: "createLogRequest"
method: POST
path: "/platform/deployments/{id}/logs/requests"
tags: ["Platform"]
---

# createLogRequest

`POST /platform/deployments/{id}/logs/requests`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/deployments/{id}/logs/requests`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Read scope. Start (or reuse) the asynchronous log tail of a deployment: the same logs_tail job the synchronous /logs route enqueues, answered 202 with a request handle instead of holding the worker. ONE live request per deployment — a second create returns the existing one with reused: true rather than starting a second tail. The request row and its chunks expire after 60 minutes (daily prune). The synchronous POST /platform/deployments/{id}/logs route is unchanged.

## Path parameters

- `id` string, required

## Request body

- object
  - `lines` integer
  - `since_seconds` integer

## Response `202`

request_id, reused, expires_at and the poll/stream URLs

## Other responses

- `400`: Invalid input
- `401`: Authentication missing
- `404`: Deployment not found

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)