---
title: "Test destination settings before saving"
method: POST
path: "/observability/destinations/test"
tags: ["Gateway"]
---

# Test destination settings before saving

`POST /observability/destinations/test`

## Request

- Base URL: `https://api.phaseo.app/v1`
- URL: `https://api.phaseo.app/v1/observability/destinations/test`
- Auth: HTTP bearer

Sends a sample trace without its messages to the settings given, the way the gateway delivers traces. Nothing is saved. Owners and admins; settings:write required.

## Request body

- ObservabilityDestinationTestRequest
  - `type` 'arize' | 'axiom' | 'bigquery' | 'braintrust' | 'clickhouse' | 'comet_opik' | 'datadog' | 'dynatrace' | 'elastic' | 'gcs' | 'grafana_cloud' | 'honeycomb' | 'langfuse' | 'langsmith' | 'new_relic' | 'otel_collector' | 'posthog' | 'r2' | 'respan' | 's3' | 'sentry' | 'snowflake' | 'wandb_weave' | 'webhook', required
  - `config` object, required: The destination's settings, as for creating one.

## Response `200`

Test result; ok is false when the destination refused or could not be reached

- ObservabilityDestinationTestResponse
  - `data` object, required
    - `ok` boolean
    - `status` string
    - `http_status` integer, nullable
    - `error` string, nullable

## Other responses

- `400`: Invalid type or settings
- `401`: Unauthorized

## Changes

- **2026-10-28** `72ba9c856a2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/observability/destinations/test/post.md)

---

[API](https://skmtc.dev/phaseo/apis/phaseo-gateway-api.md) - [All operations](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/revisions/5ca9bb220d25?raw)