Skip to main content
GET
/
api
/
v1
/
web-integrations
/
discover
Validate integration token
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://blackbox.dasha.ai/api/v1/web-integrations/discover', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "integrationId": "<string>",
  "agentId": "<string>",
  "name": "<string>",
  "enabled": true,
  "features": [
    {
      "name": "AllowWebCall",
      "enabled": true
    }
  ],
  "widgetAppearance": {
    "theme": "<string>",
    "position": "<string>",
    "colors": {},
    "customStyles": {}
  },
  "description": "<string>",
  "tools": [
    "<string>"
  ]
}

Public Endpoint

This endpoint does not require API key authentication. It is designed for external systems to validate their integration tokens and discover configuration.

Validation Checks

  • Token validity and expiration
  • Origin restrictions (CORS)
  • Integration status

Query Parameters

token
string

Access token to validate

Response

Returns integration configuration successfully

Public web integration information for discovery endpoint. Contains only safe, non-sensitive data that can be exposed publicly.

integrationId
string
required

Integration identifier

Minimum string length: 1
agentId
string
required

Associated agent identifier

Minimum string length: 1
name
string
required

Integration name

Minimum string length: 1
enabled
boolean
required

Whether the integration is active

features
object[]
required

Enabled features

widgetAppearance
object
required

Widget appearance configuration

description
string | null

Integration description

tools
string[] | null

Tool names executed via websocket