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));curl --request GET \
--url https://blackbox.dasha.ai/api/v1/web-integrations/discover \
--header 'Authorization: Bearer <token>'import requests
url = "https://blackbox.dasha.ai/api/v1/web-integrations/discover"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"integrationId": "<string>",
"agentId": "<string>",
"name": "<string>",
"enabled": true,
"features": [
{
"name": "AllowWebCall",
"enabled": true
}
],
"widgetAppearance": {
"theme": "<string>",
"position": "<string>",
"colors": {},
"customStyles": {}
},
"description": "<string>",
"tools": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Validate integration token
Validates an access token and retrieves the associated integration configuration. This is a public endpoint used by external systems to discover integration settings. Validates both token validity and origin restrictions.
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));curl --request GET \
--url https://blackbox.dasha.ai/api/v1/web-integrations/discover \
--header 'Authorization: Bearer <token>'import requests
url = "https://blackbox.dasha.ai/api/v1/web-integrations/discover"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"integrationId": "<string>",
"agentId": "<string>",
"name": "<string>",
"enabled": true,
"features": [
{
"name": "AllowWebCall",
"enabled": true
}
],
"widgetAppearance": {
"theme": "<string>",
"position": "<string>",
"colors": {},
"customStyles": {}
},
"description": "<string>",
"tools": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<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
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.
Integration identifier
Minimum string length:
1Associated agent identifier
Minimum string length:
1Integration name
Minimum string length:
1Whether the integration is active
Enabled features
Show child attributes
Show child attributes
Widget appearance configuration
Show child attributes
Show child attributes
Integration description
Tool names executed via websocket
Was this page helpful?