Merken

Endpoints

Methode	Pad	Beschrijving
`GET`	`/brands`	Alle merken weergeven
`POST`	`/brands`	Een merk aanmaken
`GET`	`/brands/{brandId}`	Details van een merk opvragen
`PATCH`	`/brands/{brandId}`	Een merk wijzigen
`DELETE`	`/brands/{brandId}`	Een merk verwijderen

GET /brands

Geeft alle merken weer die bij het geauthenticeerde account horen.

curl https://mentova.ai/api/v1/brands \
  -H "X-API-Key: mtv_live_votre_cle"

Antwoord `200`

{
  "data": [
    {
      "id": "clxabc123",
      "name": "Acme Corp",
      "domain": "acme.com",
      "aliases": ["Acme"],
      "language": "fr",
      "country": "FR",
      "autoWeeklyAnalysis": false,
      "createdAt": "2026-01-10T09:00:00.000Z"
    }
  ]
}

POST /brands

Maakt een nieuw merk aan. Het aantal toegestane merken hangt af van uw abonnement.

Aanvraagbody

Veld	Type	Verplicht	Beschrijving
`name`	string	Ja	Naam van het merk (max. 100 tekens)
`domain`	string	Nee	Domein van het merk (max. 253 tekens)
`aliases`	string[]	Nee	Alternatieve namen om te volgen
`language`	string	Nee	BCP-47-taalcode, bijv. `fr` (2-5 tekens)
`country`	string	Nee	ISO 3166-1 alpha-2-landcode, bijv. `FR` (2-5 tekens)

curl -X POST https://mentova.ai/api/v1/brands \
  -H "X-API-Key: mtv_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "domain": "acme.com",
    "aliases": ["Acme"],
    "language": "fr",
    "country": "FR"
  }'

Antwoord `201`

{
  "data": {
    "id": "clxabc123",
    "name": "Acme Corp",
    "domain": "acme.com",
    "aliases": ["Acme"],
    "language": "fr",
    "country": "FR",
    "autoWeeklyAnalysis": false,
    "createdAt": "2026-06-01T09:00:00.000Z"
  }
}

Fouten

HTTP	code	Oorzaak
`409`	`CONFLICT`	Er bestaat al een merk met deze naam
`422`	`VALIDATION_ERROR`	Ongeldige aanvraagbody
`422`	`LIMIT_REACHED`	Limiet van het aantal merken van uw abonnement bereikt

GET /brands/

Haalt de volledige details van een merk op.

curl https://mentova.ai/api/v1/brands/clxabc123 \
  -H "X-API-Key: mtv_live_votre_cle"

Padparameters

Parameter	Beschrijving
`brandId`	ID van het merk

Antwoord `200`

{
  "data": {
    "id": "clxabc123",
    "name": "Acme Corp",
    "domain": "acme.com",
    "aliases": ["Acme"],
    "language": "fr",
    "country": "FR",
    "autoWeeklyAnalysis": false,
    "createdAt": "2026-01-10T09:00:00.000Z"
  }
}

PATCH /brands/

Wijzigt een of meer velden van een merk. Alleen de velden die in de aanvraagbody zijn opgenomen, worden bijgewerkt.

Aanvraagbody

Veld	Type	Verplicht	Beschrijving
`name`	string	Nee	Nieuwe naam (max. 100 tekens)
`domain`	string \| null	Nee	Nieuw domein, of `null` om het te verwijderen
`aliases`	string[]	Nee	Nieuwe array met aliassen
`language`	string	Nee	Taal van de belangrijkste markt (2-5 tekens, genormaliseerd: `pt-BR` wordt `pt`). Als dit veld alleen wordt meegestuurd, vervangt het de belangrijkste markt, zonder er een toe te voegen
`markets`	string[]	Nee	Gevolgde markten, in het formaat `LAND-taal` (`BE-fr`, `BE-nl`); de eerste is de belangrijkste markt. Tussen 1 en 100 items
`autoWeeklyAnalysis`	boolean	Nee	Automatische wekelijkse campagnes in- of uitschakelen

Markten volgen dezelfde regels als in de applicatie: slechts één tijdens de proefperiode van 14 dagen (403, code MARKETS_TRIAL_LIMIT), zo veel als u wilt op een betaald abonnement. De talen van extra markten moeten deel uitmaken van de aangeboden analysetalen (anders 422). Een thema kan alleen worden aangemaakt binnen een markt die het merk volgt: voeg de markt hier eerst toe voordat u de bijbehorende thema's aanmaakt (zie Thema's en prompts).

curl -X PATCH https://mentova.ai/api/v1/brands/clxabc123 \
  -H "X-API-Key: mtv_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"markets": ["BE-fr", "BE-nl"]}'

Antwoord `200`

{
  "data": {
    "id": "clxabc123",
    "name": "Acme Corp",
    "domain": "acme.com",
    "autoWeeklyAnalysis": true
  }
}

DELETE /brands/

Verwijdert een merk en alle bijbehorende gegevens definitief.

curl -X DELETE https://mentova.ai/api/v1/brands/clxabc123 \
  -H "X-API-Key: mtv_live_votre_cle"

Antwoord `200`

{
  "data": { "deleted": true }
}

Avatars

Doelgroepavatars definiëren persona-profielen die worden gebruikt om LLM-prompts tijdens campagnes van context te voorzien. Limiet per abonnement: 5 avatars per merk op Pro, onbeperkt vanaf Pro+.

Endpoints

Methode	Pad	Beschrijving
`GET`	`/brands/{brandId}/avatars`	Avatars weergeven
`POST`	`/brands/{brandId}/avatars`	Een avatar aanmaken
`PATCH`	`/brands/{brandId}/avatars/{avatarId}`	Een avatar wijzigen
`DELETE`	`/brands/{brandId}/avatars/{avatarId}`	Een avatar verwijderen

GET /brands//avatars

curl https://mentova.ai/api/v1/brands/clxabc123/avatars \
  -H "X-API-Key: mtv_live_votre_cle"

Antwoord `200`

{
  "data": [
    {
      "id": "clxavatar1",
      "brandId": "clxabc123",
      "name": "Sophie, Directrice Marketing",
      "sector": "SaaS B2B",
      "role": "Directrice Marketing",
      "objectives": "Augmenter le share of voice de la marque dans les résultats IA",
      "description": null,
      "isDefault": true,
      "createdAt": "2026-04-17T10:00:00.000Z",
      "updatedAt": "2026-04-17T10:00:00.000Z"
    }
  ]
}

POST /brands//avatars

Aanvraagbody

Veld	Type	Verplicht	Beschrijving
`name`	string	Ja	Weergavenaam van de avatar (max. 100 tekens)
`sector`	string	Ja	Sector (max. 100 tekens)
`role`	string	Ja	Rol of type persona (max. 100 tekens)
`objectives`	string	Ja	Doelen en context van deze persona (max. 500 tekens)
`description`	string	Nee	Optionele uitgebreide beschrijving (max. 1000 tekens)
`isDefault`	boolean	Nee	Instellen als standaardavatar voor nieuwe campagnes

curl -X POST https://mentova.ai/api/v1/brands/clxabc123/avatars \
  -H "X-API-Key: mtv_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sophie, Directrice Marketing",
    "sector": "SaaS B2B",
    "role": "Directrice Marketing",
    "objectives": "Augmenter le share of voice de la marque dans les résultats IA",
    "isDefault": true
  }'

Antwoord `201`

{
  "data": {
    "id": "clxavatar1",
    "brandId": "clxabc123",
    "name": "Sophie, Directrice Marketing",
    "sector": "SaaS B2B",
    "role": "Directrice Marketing",
    "objectives": "Augmenter le share of voice de la marque dans les résultats IA",
    "description": null,
    "isDefault": true,
    "createdAt": "2026-04-17T10:00:00.000Z",
    "updatedAt": "2026-04-17T10:00:00.000Z"
  }
}

PATCH /brands//avatars/

Alle velden zijn optioneel. Alleen de meegestuurde velden worden bijgewerkt.

curl -X PATCH https://mentova.ai/api/v1/brands/clxabc123/avatars/clxavatar1 \
  -H "X-API-Key: mtv_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"isDefault": false}'

Antwoord `200`

{
  "data": {
    "id": "clxavatar1",
    "isDefault": false
  }
}

DELETE /brands//avatars/

curl -X DELETE https://mentova.ai/api/v1/brands/clxabc123/avatars/clxavatar1 \
  -H "X-API-Key: mtv_live_votre_cle"

Antwoord `200`

{
  "data": { "id": "clxavatar1" }
}

Endpoints

GET /brands

Antwoord 200

POST /brands

Aanvraagbody

Antwoord 201

Fouten

GET /brands/

Padparameters

Antwoord 200

PATCH /brands/

Aanvraagbody

Antwoord 200

DELETE /brands/

Antwoord 200

Avatars

Endpoints

GET /brands//avatars

Antwoord 200

POST /brands//avatars

Aanvraagbody

Antwoord 201

PATCH /brands//avatars/

Antwoord 200

DELETE /brands//avatars/

Antwoord 200

Antwoord `200`

Antwoord `201`

Antwoord `200`

Antwoord `200`

Antwoord `200`

Antwoord `200`

Antwoord `201`

Antwoord `200`

Antwoord `200`