---
title: "Run the controlled Den egress diagnostic"
method: POST
path: "/v1/diagnostics/egress"
tags: ["Diagnostics"]
---

# Run the controlled Den egress diagnostic

`POST /v1/diagnostics/egress`

Runs fixed HTTP, redirect, OAuth-shaped, and MCP probes from the Den process to the operator-configured public Diagnostics origin.

## Response `200`

The completed diagnostic run, including a failed result when a layer did not pass.

- object
  - `runId` string, uuid, required
  - `targetOrigin` string, uri, required
  - `supportUrl` string, uri, required
  - `startedAt` string, required
  - `completedAt` string, required
  - `overallStatus` 'passed' | 'failed', required
  - `highestPassingStep` 'reachability' | 'http-methods' | 'redirect' | 'oauth-discovery' | 'oauth-token' | 'mcp-handshake', nullable, required
  - `failedStep` 'reachability' | 'http-methods' | 'redirect' | 'oauth-discovery' | 'oauth-token' | 'mcp-handshake', nullable, required
  - `steps` object[], required
    - `id` 'reachability' | 'http-methods' | 'redirect' | 'oauth-discovery' | 'oauth-token' | 'mcp-handshake', required
    - `label` string, required
    - `category` 'connectivity' | 'http' | 'oauth' | 'mcp', required
    - `status` 'passed' | 'failed' | 'skipped', required
    - `startedAt` string, required
    - `completedAt` string, required
    - `durationMs` integer, required
    - `httpStatuses` integer[], required
    - `diagnosticIds` string[], required
    - `code` string, nullable, required
    - `message` string, required
    - `owner` 'den-operator' | 'network-administrator' | 'openwork-support', required
    - `action` string, required

## Other responses

- `401` — The caller must be signed in.
- `403` — Only workspace owners and super-admins can run egress diagnostics.
- `503` — The Den operator has not configured the Diagnostics target.

---

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