---
title: "Discover Integration Spec"
method: POST
path: "/api/workspace-integrations/discover"
tags: ["workspace-integrations", "workspace-integrations"]
---

# Discover Integration Spec

`POST /api/workspace-integrations/discover`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/workspace-integrations/discover`
- Auth: none declared

Autodiscover an OpenAPI spec so the owner doesn't hand-paste it:
explicit spec_url → well-known probes under base_url → LLM fallback
from docs HTML. Validates every user-supplied URL up front (clean
400) AND fetches through the SSRF-guarded client (DNS-rebind). Never
persists — the caller reviews the returned spec before saving.

## Request body

- SrcApiWorkspaceIntegrationsDiscoverRequest: Autodiscover an OpenAPI spec for an HTTP-API integration. Provide at least one of base_url / spec_url / docs_url.
  - `base_url` string, nullable
  - `spec_url` string, nullable
  - `docs_url` string, nullable

## Response `200`

Successful Response

- DiscoverResponse
  - `spec` object, required
  - `source` string, required
  - `tool_preview` string[], required
  - `warnings` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)