Skip to main content
POST
Test the Datadog credential
Requires Admin or Owner. This contacts Datadog. Success confirms the key, not end-to-end data delivery; check delivery state after enabling exports. Invalid credentials return 422, temporary failures 503. Testing does not by itself save or enable the connection.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Body

application/json
site
enum<string>
required
Available options:
datadoghq.com,
us3.datadoghq.com,
us5.datadoghq.com,
datadoghq.eu,
ap1.datadoghq.com,
ap2.datadoghq.com,
uk1.datadoghq.com
api_key
string<password> | null
Maximum string length: 128

Response

Successful Response

message
string
default:API key verified. Data delivery is checked after export starts.
valid
boolean
default:true