---
title: "Validate Drain delivery configuration"
method: POST
path: "/v1/drains/test"
tags: ["drains"]
---

# Validate Drain delivery configuration

`POST /v1/drains/test`

Validate the delivery configuration of a Drain using sample events.

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `schemas` object, required
  - `delivery` union, required
    - object
      - `type` string, required
      - `endpoint` string, required
      - `compression` 'gzip' | 'none'
      - `encoding` 'json' | 'ndjson', required
      - `headers` object, required
      - `secret` string
    - object
      - `type` string, required
      - `endpoint` object, required
        - `traces` string, required
      - `encoding` 'proto' | 'json', required
      - `headers` object, required
      - `secret` string
    - object
      - `type` string, 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` 'private' | 'bucket-owner-read' | 'bucket-owner-full-control'

## Response `200`

- union
  - object
  - object
    - `status` string, required
    - `error` string, required
    - `endpoint` string, required

## Other responses

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

## Changes

> 39 revisions in range; 23 could not be searched.

- **2026-07-21** `2ae10ee9d21c` — 1 info
  - added the non-success response with the status `410`
- **2026-07-08** `3ff660568354` — 2 info
  - the `serverSideEncryption` request property default value `AES256` was added
  - added the non-success response with the status `402`
- **2026-06-22** `7bd30e62d868` — 1 info
  - added `subschema #3` to the `delivery` request property `oneOf` list

[Change history](https://skmtc.dev/vercel/apis/api/changes/v1/drains/test/post.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) · [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/api/revisions/4191ba96b0c1/schema)