A short, human-readable summary of the problem.
A human-readable explanation specific to this occurrence of the problem.
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
A URI reference that identifies the problem type
Retrieves a ConstraintViolation resource.
Retrieves a ConnectorImportRun resource.
Slug of a globally enabled connector file template (CRM).
Map of discriminant values to location UUIDs
Retrieves a ConnectorCreateFromCrm resource.
Whether this CRM template carries a default discriminant column, i.e. the COLUMN strategy can be offered.
The default discriminant column of the CRM template, null when it has none.
Retrieves a ConnectorFileTemplate resource.
Deletes the ConnectorSetupCancel resource.
Retrieves a ConnectorSetupCancel resource.
Retrieves a ConnectorSetupColumnValues resource.
Retrieves a ConnectorSetupConfigureColumns resource.
Retrieves a ConnectorSetupConfigureLocation resource.
Retrieves a ConnectorSetupFinalize resource.
Retrieves a ConnectorSetupImport resource.
Retrieves a ConnectorSetupImportStatus resource.
Retrieves a ConnectorSetupReanalyze resource.
Retrieves a ConnectorSetupUpload resource.
This DTO operate in the app context (not admin).
Resolved perimeter grain — always organization on this surface.
Theme columns, ordered by descending network volume; empty on the empty/degraded state.
Pinned organization row (« Réseau global »); null on the empty/degraded state.
Establishment rows, ordered by descending volume; empty on the empty/degraded state.
Read-only establishments × themes heatmap served by GET /api/semantic/heatmap (BIM-1906). Feeds the comparison matrix: rows = establishments of the caller network, columns = themes, each cell coloured by sentiment. Every row also carries a global sentiment score, its trend and its analysed-review volume (the sortable "Score global" / "Avis" columns), and a pinned organization row (`organization`) tops the matrix. Backed by the read-only analytics warehouse (mart_semantic_period), volume-weighted per (location, theme) and per location, then aggregated network-wide across the caller's reach. Network-only surface (like the positioning map): an establishment-scoped (single-location) caller has nothing to compare and is denied (403) — the front hides the section for that profile. Gated by the SEMANTIC_ANALYSIS organization flag; the perimeter is always the caller's own organization (resolved from the token, never the URL) bounded to their reach (org admin ⇒ whole network; multi-location manager ⇒ their SEMANTICS-reachable locations). `available` is false (themes/rows empty, organization null) when the read-only warehouse is unreachable — the endpoint degrades instead of erroring. A network with no analysed establishment yields `available:true` with empty `themes`/`rows` and a null `organization`, which the front renders as the empty state.
Resolved perimeter grain: organization, location_group or location.
Uuid of the resolved perimeter (location or group); null at the organization grain.
Human name of the resolved perimeter (location or group); null at the organization grain.
Rank of the perimeter within its family; null at the organization grain.
Group dimension type (e.g. "Marque", "Pôle"); only set at the location_group grain.
Total analysed reviews over the perimeter and period (heatmap-aligned volume).
Distinct parent themes mentioned over the perimeter and period.
Establishments carrying analysed data in the perimeter (1 at the establishment grain).
Read-only semantic overview served by GET /api/semantic/overview. Feeds both the narrative synthesis (BIM-1899) and the KPI cards (BIM-1900) in a single call. Backed by the read-only analytics warehouse: scores/themes from mart_semantic_scores, the three volume counts (nbReviewsAnalyzed / nbThemes / nbEstablishments) from mart_semantic_period, aggregated for the resolved perimeter with the same rule as the heatmap (BIM-1897). Values are raw numbers or warehouse-provided theme/group names; every user-facing label lives in the front i18n. The `scope` query parameter selects the perimeter grain — organization (the organization headline), location_group (one pôle/marque), or location (one location) — always bounded to the caller's organization and reach (BIM-1897/1898). `scope`, `perimeterId` and `perimeterName` echo the resolved perimeter so the front can render its breadcrumb. `available` is false (all score/theme fields null) when no row exists for the resolved perimeter and period — the front then renders the empty state (BIM-1900). It is also false, with the same shape, when the read-only warehouse is unreachable: the endpoint degrades instead of erroring.
Establishment points, ordered by descending volume; empty on the empty/degraded state.
Retrieves a SemanticPositioning resource.
Read-only network comparison dataset served by GET /api/semantic/positioning (BIM-1904 / BIM-1905). Feeds two views of the same "compare my establishments" data: the positioning scatter (BIM-1904 — one bubble per establishment, positioned by review volume X and global sentiment score Y, coloured by sentiment) and the sortable comparison table (BIM-1905 — one row per establishment with Avis mentionnés, Score de sentiment, % Promoteurs, % Détracteurs and Évolution). Backed by the read-only analytics warehouse (mart_semantic_period for volume/score/delta, int_semantic_review_enriched for the promoter/detractor rates), aggregated per location across the caller's network reach. Network-only surface: an establishment-scoped (single-location) caller has nothing to compare and is denied (403) — the front hides the section for that profile. Gated by the SEMANTIC_ANALYSIS organization flag; the perimeter is always the caller's own organization (resolved from the token, never the URL) bounded to their reach (org admin ⇒ whole network; multi-location manager ⇒ their SEMANTICS-reachable locations). `available` is false (entities empty) when the read-only warehouse is unreachable — the endpoint degrades instead of erroring. A network with no analysed establishment yields `available:true` with an empty `entities` list, which the front renders as the empty state.
Resolved theme label; null when the topic is out of the perimeter (unavailable).
Focused sub-theme (echo of the `sub_topic` query); null on the whole-theme view.
Focused recap: volume-weighted sentiment score (0–100); null when no mention.
Focused recap: score delta (last vs first month of the window); null when no mention.
Focused recap: number of reviews mentioning the focus over the window.
Focused recap: share of analysed reviews mentioning the focus, in percent (one decimal).
Sub-theme pills of the theme, ordered by descending volume; empty on the empty/degraded state.
Monthly score series of the focus, ordered ascending; empty on the empty/degraded state.
Retrieves a SemanticTopicDetail resource.
Read-only theme detail drill-in served by GET /api/semantic/topics/{topicId} (BIM-1903). Opened from a map bubble (BIM-1901): the bubble's warehouse topic_id resolves to a theme (topic_name), and the detail returns that theme's numeric recap (score / volume / mention rate), its clickable sub-theme pills and its monthly score series. Passing `sub_topic` re-focuses the recap and the curve on a single sub-theme while keeping the pills. Shares the period + perimeter contract of GET /api/semantic/overview: gated by the SEMANTIC_ANALYSIS organization flag, perimeter always bounded to the caller's organization (resolved from the token, never the URL) and reach (BIM-1897/1898). `available` is false (recap null, empty lists) when the read-only warehouse is unreachable or the topic id is out of the perimeter — the endpoint degrades instead of erroring.
Bubble grain echoed back: theme (one bubble per theme) or sub_theme (one per sub-theme).
Theme bubbles, ordered by descending volume; empty on the empty state / degraded warehouse.
Read-only thematic map served by GET /api/semantic/topics (BIM-1901). Feeds the theme cartography: one bubble per topic, positioned by score / mention rate, sized by volume. Backed by the read-only analytics warehouse (mart_semantic_period), volume-weighted across the resolved perimeter. Shares the period + perimeter contract of GET /api/semantic/overview: gated by the SEMANTIC_ANALYSIS organization flag, perimeter always bounded to the caller's organization (resolved from the token, never the URL) and reach (BIM-1897/1898). `available` is false (topics empty) when the read-only warehouse is unreachable — the endpoint degrades instead of erroring. An empty perimeter (no theme mentioned over the window) yields `available:true` with an empty `topics` list, which the front renders as the empty state.
Human-readable campaign name (1-255 chars).
Lifecycle status. A campaign starts as `draft`, becomes `active` once started, can be `paused`, and ends `archived` (read-only). Driven by the activate/pause/archive operations, not writable directly.
Ordered steps of the campaign. The first step has `previousStep: null`; each subsequent step references its predecessor.
When the campaign was migrated from the legacy system. Null for campaigns created natively.
UUIDs of the locations the campaign targets.
Filters narrowing which contacts the campaign targets. Empty means all eligible contacts.
Retrieves a LocationComparisonFilter resource.
Updates the LocationComparisonFilter resource.
Deletes the LocationComparisonFilter resource.
Replaces the LocationComparisonFilter resource.
Pages Jaunes matching status resolved on the fly from RPS.
Updates the LocationExportConfig resource.
Retrieves a LocationExportConfig resource.
Deletes the LocationExportConfig resource.
Username or email used during oauth login
Comptes dont la récupération des fiches a échoué côté Google. Le service de synchronisation attrape l'erreur par compte sans interrompre les autres : sans cette exposition, un échec Google est indistinguable d'un groupe vide côté client.
Updates the UserReviewResponse resource.
Retrieves a UserReviewResponse resource.
Deletes the UserReviewResponse resource.
Retrieves the collection of ConnectorImportRun resources.
The collection of ConnectorImportRun resources
Retrieves the collection of PresencePostGroup resources.
The collection of PresencePostGroup resources
Retrieves the collection of FeatureFlag resources.
Creates a ConnectorCreateFromCrm resource.
The collection of ConnectorCreateFromCrm resources
Retrieves the collection of ConnectorFileTemplate resources.
The collection of ConnectorFileTemplate resources
Retrieves the collection of Connector resources.
Creates a ConnectorSetupConfigureColumns resource.
The collection of ConnectorSetupConfigureColumns resources
Creates a ConnectorSetupConfigureLocation resource.
The collection of ConnectorSetupConfigureLocation resources
Creates a ConnectorSetupFinalize resource.
The collection of ConnectorSetupFinalize resources
Creates a ConnectorSetupImport resource.
The collection of ConnectorSetupImport resources
Creates a ConnectorSetupReanalyze resource.
The collection of ConnectorSetupReanalyze resources
Creates a ConnectorSetupUpload resource.
The collection of ConnectorSetupUpload resources
The collection of PagesJaunesScrape resources
Retrieves the collection of License resources.
Retrieves the collection of UserPermission resources.
The collection of UserPermission resources
Retrieves the collection of ContactExtraData resources.
The collection of ContactExtraData resources
Retrieves the collection of Experience resources.
Retrieves the collection of Campaign resources.
Retrieves the collection of Question resources.
Retrieves the collection of Survey resources.
Creates a LocationComparisonFilter resource.
Retrieves the collection of LocationComparisonFilter resources.
The collection of LocationComparisonFilter resources
Retrieves the collection of ReviewFilter resources.
The collection of ReviewFilter resources
Retrieves the collection of Location resources.
Creates a LocationExportConfig resource.
Retrieves the collection of LocationExportConfig resources.
The collection of LocationExportConfig resources
Retrieves the collection of LocationGroup resources.
The collection of LocationGroup resources
Retrieves the collection of Organization resources.
The collection of Organization resources
Retrieves the collection of PlatformPage resources.
The collection of PlatformPage resources
Retrieves the collection of LinkUser resources.
Retrieves the collection of ModerationEvent resources.
The collection of ModerationEvent resources
Retrieves the collection of Notification resources.
The collection of Notification resources
Retrieves the collection of Rule resources.
Retrieves the collection of OauthConnection resources.
The collection of OauthConnection resources
Retrieves the collection of OauthLocation resources.
The collection of OauthLocation resources
Retrieves the collection of OauthMatching resources.
The collection of OauthMatching resources
Retrieves the collection of PMAttribute resources.
Retrieves the collection of PMCategory resources.
Retrieves the collection of Report resources.
Retrieves the collection of ResponseTemplate resources.
The collection of ResponseTemplate resources
Retrieves the collection of Review resources.
The collection of UserReviewResponse resources
Retrieves the collection of User resources.
Retrieves the collection of Widget resources.
The message associated with the violation