---
title: "Retrieve logs for a custom pipeline"
method: GET
path: "/pipelines/custom/{id}/logs"
tags: ["Pipeline Operations"]
---

# Retrieve logs for a custom pipeline

`GET /pipelines/custom/{id}/logs`

## Request

- Base URL: `https://replace-with-account.api.data.decodable.co/v1alpha2`
- URL: `https://replace-with-account.api.data.decodable.co/v1alpha2/pipelines/custom/{id}/logs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/decodable/apis/decodable-data-plane/docs/pipelines/custom/:id/logs/get.ts> (a function with typed inputs; its response is checked against the schema)

Requires a bearer token for retrieving the logs from a custom pipeline issued by the control plane API.
Will return a set of plaintext logs when using the `Accept: text/plain` header. If using
`Accept: text/event-stream`, this will return a server-sent-event stream of logs.

Note that the query parameters must be the exact same (and in the same order) as was
used in the request for a token to the control plane.

## Query parameters

- `task_index` integer
- `num_lines` integer
- `follow` boolean

## Response `200`

A logs response

## Other responses

- `400`: An invalid request was received.
- `default`: An error has occurred.

---

[API](https://skmtc.dev/decodable/apis/decodable-data-plane.md) - [All operations](https://skmtc.dev/decodable/apis/decodable-data-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/decodable/apis/decodable-data-plane/revisions/4303384f9994?raw)
