---
title: "Retrieves a list of all the Log Drains (deprecated)"
method: GET
path: "/v1/log-drains"
tags: ["logDrains"]
---

# Retrieves a list of all the Log Drains (deprecated)

`GET /v1/log-drains`

Retrieves a list of all the Log Drains owned by the account. This endpoint must be called with an account AccessToken (integration OAuth2 clients are not allowed). Only log drains owned by the authenticated account can be accessed.

## Query parameters

- `projectId` string
- `projectIdOrName` string
- `includeMetadata` boolean
- `teamId` string
- `slug` string

## Response `200`

- union
  - object[]
    - `createdFrom` string, required
    - `clientId` string
    - `configurationId` string
    - `projectsMetadata` object[], nullable
      - `id` string, required
      - `name` string, required
      - `framework` 'actix-web' | 'angular' | 'ash' | 'astro' | 'axum' | 'blitzjs' | 'brunch' | 'bun' | 'container' | 'create-react-app' | 'django' | 'docusaurus' | 'docusaurus-2' | 'dojo' | 'eleventy' | 'elysia' | 'ember' | 'eve' | 'express' | 'fastapi' | 'fasthtml' | 'fastify' | 'flask' | 'gatsby' | 'go' | 'gridsome' | 'h3' | 'hexo' | 'hono' | 'hugo' | 'hydrogen' | 'ionic-angular' | 'ionic-react' | 'jekyll' | 'koa' | 'mastra' | 'middleman' | 'nestjs' | 'nextjs' | 'nitro' | 'node' | 'nuxtjs' | 'parcel' | 'polymer' | 'preact' | 'python' | 'react-router' | 'redwoodjs' | 'remix' | 'ruby' | 'rust' | 'saber' | 'sanity' | 'sanity-v2' | 'sapper' | 'scully' | 'services' | 'solidstart' | 'solidstart-1' | 'stencil' | 'storybook' | 'svelte' | 'sveltekit' | 'sveltekit-1' | 'tanstack-start' | 'tanstack-start-lovable' | 'umijs' | 'vite' | 'vitepress' | 'vue' | 'vuepress' | 'xmcp' | 'zola' | 'null', nullable
      - `latestDeployment` string
    - `integrationIcon` string
    - `integrationConfigurationUri` string
    - `integrationWebsite` string
  - object
    - `drains` union, required
      - object[]
        - `id` string, required
        - `createdAt` number, required
        - `updatedAt` number, required
        - `projectIds` string[]
        - `name` string, required
        - `teamId` string, nullable
        - `ownerId` string, required
        - `status` 'disabled' | 'enabled' | 'errored'
        - `firstErrorTimestamp` number
        - `disabledAt` number
        - `disabledBy` string
        - `disabledReason` 'account-plan-downgrade' | 'disabled-by-admin' | 'disabled-by-owner' | 'feature-not-available'
        - `schemas` object, required
          - `log` object
          - `trace` object
          - `analytics` object
          - `speed_insights` object
          - `ai_gateway` object
          - `audit_log` object
          - `connect` object
        - `delivery` union, required
          - object
            - `type` 'http', required
            - `endpoint` string, required
            - `encoding` 'json' | 'ndjson', required
            - `compression` 'gzip' | 'none'
            - `headers` object, required
            - `secret` union
              - …
          - object
            - `type` 'otlphttp', required
            - `endpoint` object, required
              - …
            - `encoding` 'json' | 'proto', required
            - `headers` object, required
            - `secret` union
              - …
          - object
            - `type` 'clickhouse', required
            - `endpoint` string, required
            - `table` string, required
          - object
            - `type` 's3', required
            - `endpoint` string, required
            - `encoding` 'json' | 'ndjson', required
            - `compression` 'none', required
            - `fileStructure` 'hive', required
            - `roleArn` string, required
            - `region` string, required
            - `serverSideEncryption` 'AES256' | 'aws:kms' | 'aws:kms:dsse'
            - `objectAcl` 'authenticated-read' | 'aws-exec-read' | 'bucket-owner-full-control' | 'bucket-owner-read' | 'private' | 'public-read' | 'public-read-write'
          - object
            - `type` 'internal', required
            - `target` 'vercel-otel-traces-db', required
        - `sampling` object[]
          - `type` 'head_sampling', required
          - `rate` number, required
          - `env` 'preview' | 'production'
          - `requestPath` string
        - `source` union, required
          - object
            - `kind` 'self-served', required
          - object
            - `kind` 'integration', required
            - `resourceId` string
            - `externalResourceId` string
            - `integrationId` string, required
            - `integrationConfigurationId` string, required
        - `filterV2` object
          - `version` 'v2', required
          - `filter` union, required
            - object
              - …
            - object
              - …
      - object[]
        - `id` string, required
        - `createdAt` number, required
        - `updatedAt` number, required
        - `projectIds` string[]
        - `name` string, required
        - `teamId` string, nullable
        - `ownerId` string, required
        - `status` 'disabled' | 'enabled' | 'errored'
        - `firstErrorTimestamp` number
        - `disabledAt` number
        - `disabledBy` string
        - `disabledReason` 'account-plan-downgrade' | 'disabled-by-admin' | 'disabled-by-owner' | 'feature-not-available'
        - `schemas` object, required
          - `log` object
          - `trace` object
          - `analytics` object
          - `speed_insights` object
          - `ai_gateway` object
          - `audit_log` object
          - `connect` object
        - `delivery` union, required
          - object
            - `type` 'http', required
            - `endpoint` string, required
            - `encoding` 'json' | 'ndjson', required
            - `compression` 'gzip' | 'none'
            - `headers` object, required
            - `secret` union
              - …
          - object
            - `type` 'otlphttp', required
            - `endpoint` object, required
              - …
            - `encoding` 'json' | 'proto', required
            - `headers` object, required
            - `secret` union
              - …
          - object
            - `type` 'clickhouse', required
            - `endpoint` string, required
            - `table` string, required
          - object
            - `type` 's3', required
            - `endpoint` string, required
            - `encoding` 'json' | 'ndjson', required
            - `compression` 'none', required
            - `fileStructure` 'hive', required
            - `roleArn` string, required
            - `region` string, required
            - `serverSideEncryption` 'AES256' | 'aws:kms' | 'aws:kms:dsse'
            - `objectAcl` 'authenticated-read' | 'aws-exec-read' | 'bucket-owner-full-control' | 'bucket-owner-read' | 'private' | 'public-read' | 'public-read-write'
          - object
            - `type` 'internal', required
            - `target` 'vercel-otel-traces-db', required
        - `sampling` object[]
          - `type` 'head_sampling', required
          - `rate` number, required
          - `env` 'preview' | 'production'
          - `requestPath` string
        - `source` union, required
          - object
            - `kind` 'self-served', required
          - object
            - `kind` 'integration', required
            - `resourceId` string
            - `externalResourceId` string
            - `integrationId` string, required
            - `integrationConfigurationId` string, required
        - `filterV2` object
          - `version` 'v2', required
          - `filter` union, required
            - object
              - …
            - object
              - …
        - `integrationIcon` string
        - `integrationConfigurationUri` string
        - `integrationWebsite` string
        - `projectAccess` union
          - object
            - `access` 'all', required
            - `managedBy` 'drain' | 'integration', required
          - object
            - `access` 'some', required
            - `projectIds` string[], required
            - `managedBy` 'drain' | 'integration', required

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)