---
title: "Explore And Discover"
method: POST
path: "/api/workspace-integrations/explore-and-discover"
tags: ["workspace-integrations", "workspace-integrations"]
---

# Explore And Discover

`POST /api/workspace-integrations/explore-and-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/explore-and-discover`
- Auth: none declared

One-call AUTOMATIC discovery: headless read-only crawl of the app via the
saved identity → infer the spec + auth from the captured traffic. Read-only
(navigation only — never triggers writes). For write tools, record those
actions manually. This is the agent-/UI-friendly 'auto-discover everything'.

## Request body

- RecordStartRequest: Open the saved identity's browser (authenticated) for user-guided traffic recording — the user clicks the features they want as tools.
  - `identity_id` integer, required
  - `base_url` string, required

## Response `200`

Successful Response

- DiscoverFromSessionResponse
  - `spec` object, required
  - `source` string, required
  - `tool_preview` string[], required
  - `warnings` string[], required
  - `auth_candidates` object[], 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)