Deployments via de API
Een deployment is een variant van de widget met eigen instellingen, zoals voorbeeldvragen, teksten en vormgeving (zie De widget op je website). Via de API kun je de deployments in je omgeving alleen-lezen opvragen, bijvoorbeeld om ze in een eigen beheerscherm te tonen of om in een integratie de juiste deployment te kiezen.
Deze pagina gaat uit van de base-URL, authenticatie en headers uit Werken met de API.
Endpoints
- Lijst ophalen:
GET https://{klant}.vragen.ai/api/v1/deployments - Eén ophalen:
GET https://{klant}.vragen.ai/api/v1/deployments/{id}
Aanmaken, wijzigen of verwijderen via de API kan niet; dat doe je in je vragen.ai-omgeving.
Velden
| Veld | Betekenis |
|---|---|
name |
De naam van de deployment. |
slug |
De technische naam die je in de embed-code of link gebruikt (de deployment-parameter). |
build_type |
Hoe het venster verschijnt (bijvoorbeeld inline, overlay of zijpaneel). |
trigger |
Hoe het venster wordt geopend of geplaatst. |
created_at |
Wanneer de deployment is aangemaakt. |
updated_at |
Wanneer de deployment voor het laatst is gewijzigd. |
Voorbeeld response
GET https://{klant}.vragen.ai/api/v1/deployments
{
"data": [
{
"type": "deployments",
"id": "1",
"attributes": {
"name": "Website",
"slug": "website",
"build_type": "embed",
"trigger": "embed",
"created_at": "2026-01-15T09:00:00+00:00",
"updated_at": "2026-03-02T14:30:00+00:00"
}
}
]
}
Support
Kom je er niet uit? Mail ons supportteam via service@vragen.ai.