> ## Documentation Index > Fetch the complete documentation index at: https://developers.marko.fr/llms.txt > Use this file to discover all available pages before exploring further. # Créer une vue sauvegardée pour le sujet délégué > Exige une allowlist explicite sur la clé et la capacité `saved_views`. **Scope requis :** `users:write`. [Scopes et délégation](/scopes-and-delegation). **Délégation utilisateur :** exactement un header `X-Marko-Delegated-User-Id` ou `X-Marko-Delegated-User-Email`. **Accès complémentaire :** allowlist utilisateur explicite sur la clé et capacité `saved_views`. Le sujet doit être approuvé et appartenir à la même entité. **Idempotence :** header `Idempotency-Key` obligatoire. Pour reprendre la même mutation, réutiliser la même clé et le même contenu. [Écritures et idempotence](/writes-and-idempotency). ## OpenAPI ````yaml /openapi.json post /users/me/saved-views openapi: 3.1.0 info: title: MARKO External Partner API version: v1 description: >- Stable external API contract for the live environment. Authentication flow for partner integrations: 1. Generate an API key from the MARKO entity admin API section. 2. Keep the raw API secret server-side and use it only to sign `POST /v1/auth/token`. 3. Build the canonical message `MARKO-EXTERNAL-API-TOKEN-V1\n{key_id}\n{timestamp}\n{nonce}`. 4. Sign that message with HMAC-SHA256 and send the hex signature with `key_id`, `timestamp` and `nonce`. 5. Use the returned short-lived bearer on business endpoints as `Authorization: Bearer `. The raw API secret must never be sent on business endpoints. This public contract intentionally excludes beta endpoints. Référence enrichie pour les développeurs et les assistants IA. Exemples synthétiques; les champs sont extraits des modèles et sérialiseurs de la version indiquée dans x-documentation-provenance. servers: - url: https://partner-api.marko.fr/v1 security: - BearerAuth: [] tags: - name: auth x-group: Authentification - name: entity x-group: Entité - name: portfolio x-group: Portefeuille - name: deals x-group: Deals - name: fonds x-group: Fonds - name: spvs x-group: SPV - name: operations x-group: Opérations - name: taxonomies x-group: Taxonomies - name: import-jobs x-group: Imports par lot - name: comments x-group: Commentaires - name: documents x-group: Documents - name: users x-group: Utilisateurs - name: settings x-group: Paramètres - name: rcci x-group: Conformité RCCI - name: field-definitions x-group: Champs métier - name: search x-group: Recherche - name: operateurs x-group: Opérateurs - name: alerts x-group: Alertes - name: notifications x-group: Notifications - name: calendar x-group: Calendrier - name: enrichment x-group: Enrichissement SIREN - name: reports x-group: Exports - name: reporting x-group: Templates de reporting - name: workflows x-group: Workflows et extraction IA - name: tasks x-group: Tâches externalDocs: description: Download the matching Postman collection. url: /v1/postman.json paths: /users/me/saved-views: post: tags: - users summary: Créer une vue sauvegardée pour le sujet délégué description: >- Exige une allowlist explicite sur la clé et la capacité `saved_views`. **Scope requis :** `users:write`. [Scopes et délégation](/scopes-and-delegation). **Délégation utilisateur :** exactement un header `X-Marko-Delegated-User-Id` ou `X-Marko-Delegated-User-Email`. **Accès complémentaire :** allowlist utilisateur explicite sur la clé et capacité `saved_views`. Le sujet doit être approuvé et appartenir à la même entité. **Idempotence :** header `Idempotency-Key` obligatoire. Pour reprendre la même mutation, réutiliser la même clé et le même contenu. [Écritures et idempotence](/writes-and-idempotency). operationId: users_saved-views_create parameters: - in: header name: X-Request-ID required: false description: >- Partner-generated correlation identifier echoed in logs and error payloads. schema: type: string example: marko-users-saved-views-create - in: header name: Idempotency-Key required: true description: >- Required for every write, including environments where replay deduplication is disabled. Reuse the same value when retrying the same logical write and use a new value for a different write. schema: type: string maxLength: 255 pattern: ^[!-~]+$ - name: X-Marko-Delegated-User-Id in: header required: false schema: type: string description: >- Fournir exactement un des deux headers de délégation (Id ou Email), dans la même entité. Ils sont mutuellement exclusifs. Voir le guide Scopes et délégation. - name: X-Marko-Delegated-User-Email in: header required: false schema: type: string description: >- Fournir exactement un des deux headers de délégation (Id ou Email), dans la même entité. Ils sont mutuellement exclusifs. Voir le guide Scopes et délégation. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SavedViewCreate' example: entity_type: operations name: Vue exemple filters: {} columns: - name - status sort: sort_by: updated_at sort_order: desc responses: '201': description: Successful response content: application/json: schema: $ref: '#/components/schemas/SavedViewResponse' example: id: 11111111-1111-1111-1111-111111111111 user_id: example entity_type: operations name: Pipeline closing filters: {} columns: [] sort: {} is_default: false created_at: '2026-10-01T10:00:00Z' updated_at: '2026-10-01T10:00:00Z' '400': description: Invalid Idempotency-Key header content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Bad Request status: 400 detail: >- Idempotency-Key must contain at most 255 visible ASCII characters without spaces. request_id: req_example_partner_call '401': description: Authentication required content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unauthorized status: 401 detail: A valid bearer token is required. request_id: req_example_partner_call '403': description: Scope, route or IP restriction content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Forbidden status: 403 detail: The API key does not allow this operation. request_id: req_example_partner_call '404': description: >- Not Found — refus déclaré dans le handler ou un helper de cette route. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '409': description: Idempotency or write target conflict content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Conflict status: 409 detail: >- The idempotency key payload, external reference, target, or source conflicts with an existing write. request_id: req_example_partner_call '422': description: Validation failed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unprocessable Content status: 422 detail: The request payload or parameters are invalid. request_id: req_example_partner_call '428': description: Required Idempotency-Key header is missing content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Precondition Required status: 428 detail: The Idempotency-Key header is required. request_id: req_example_partner_call '429': description: Rate limit or progressive ban headers: Retry-After: description: Cooldown in seconds before retrying the request. schema: type: string content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Too Many Requests status: 429 detail: The request rate limit was exceeded. request_id: req_example_partner_call '500': description: Unexpected server error content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Internal Server Error status: 500 detail: An unexpected server error occurred. request_id: req_example_partner_call deprecated: false security: - BearerAuth: [] components: schemas: SavedViewCreate: properties: name: type: string maxLength: 200 minLength: 1 title: Name description: Display name of the saved view icon: type: string enum: - bookmark - briefcase - building - calendar - chart - clock - filter - flag - shield - star - table - target description: >- Icône d'affichage de la vue sauvegardée; respecter la liste de valeurs autorisées. color: type: string enum: - amber - cyan - emerald - rose - slate - violet description: >- Couleur d'affichage; respecter les valeurs ou le format indiqués dans le schéma. filters: type: object maxProperties: 24 propertyNames: pattern: ^[a-z][a-z0-9_]{0,63}$ additionalProperties: true description: >- État de filtre; pour une vue operations, seules les clés décrites par le contrat conditionnel de création sont acceptées. columns: type: array maxItems: 64 items: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ description: Colonnes à afficher, dans l'ordre transmis. sort: type: object maxProperties: 4 propertyNames: pattern: ^[a-z][a-z0-9_]{0,63}$ additionalProperties: true description: >- Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint. entity_type: type: string maxLength: 50 minLength: 1 title: Entity Type description: 'Target entity: operations, operateurs, documents' is_default: type: boolean title: Is Default description: Set as default view default: false type: object required: - name - entity_type title: SavedViewCreate description: >- État de vue limité à 16 384 octets JSON pour filters, columns et sort. Le nom est normalisé et doit rester non vide. Les allowlists operations sont contrôlées selon le type de la vue, y compris lors d'un update. allOf: - if: required: - entity_type properties: entity_type: const: operations description: Type de ressource auquel se rapporte la vue ou le traitement. then: properties: filters: propertyNames: enum: - classe_actif - cycle_interne - operateur_id - preset - search - statut - statut_interne - statut_operationnel - type_investissement description: Filtres enregistrés pour la vue, le dashboard ou le template. columns: items: type: string enum: - activity_level - classe_actif - completeness - completeness_bar - completeness_score - created_at - created_year - data_quality - date_debut_financement - date_echeance - date_echeance_contractuelle - date_echeance_prorogee - date_investissement - date_sortie_effective - date_sortie_previsionnelle - days_since_update - dscr - duree_initiale_mois - duree_reelle_mois - ecart_horizon_investissement_mois - encours - fond_name - horizon_contractuel_mois - horizon_investissement_actualise_mois - icr - id - intervenant_nom - lifecycle_state - ltv - montant_nominal - montant_total_investi - montant_total_remonte - name - operateur_nom - perte_latente - phase - phase_group - responsable_interne - retard_mois - risk_bucket - risk_grade - risk_score - spv_name - status - status_label - statut_interne - statut_operationnel - tri_operation - type_investissement - type_operation - updated_at - updated_month - updated_year - version - version_label - visuel description: Colonnes à afficher, dans l'ordre transmis. sort: type: object additionalProperties: false properties: sort_by: type: string enum: - classe_actif - created_at - date_investissement - date_sortie_effective - date_sortie_previsionnelle - name - phase - risk_score - status - updated_at description: Clé de la colonne utilisée pour le tri de la vue. sort_order: type: string enum: - asc - desc description: Position de la tâche dans le board de son opération. description: Critères de tri enregistrés pour la vue. SavedViewResponse: properties: id: type: string format: uuid title: Id description: Identifiant MARKO de la ressource. user_id: type: string title: User Id description: Identifiant utilisateur MARKO; il n'est pas nécessairement un UUID. entity_type: type: string title: Entity Type description: Type de ressource auquel se rapporte la vue ou le traitement. name: type: string title: Name description: >- Nom de la ressource. Les recherches exactes et partielles sont décrites au niveau de la route. icon: type: string title: Icon default: bookmark description: >- Icône d'affichage de la vue sauvegardée; respecter la liste de valeurs autorisées. color: type: string title: Color default: slate description: >- Couleur d'affichage; respecter les valeurs ou le format indiqués dans le schéma. filters: additionalProperties: true type: object title: Filters description: >- Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint. columns: items: type: string type: array title: Columns description: Colonnes à afficher, dans l'ordre transmis. sort: additionalProperties: true type: object title: Sort description: >- Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint. is_default: type: boolean title: Is Default description: Indique si cette vue ou ce template est défini par défaut. created_at: type: string format: date-time title: Created At description: Date de création au format ISO 8601. updated_at: type: string format: date-time title: Updated At description: Date de dernière modification au format ISO 8601. type: object required: - id - user_id - entity_type - name - filters - columns - sort - is_default - created_at - updated_at title: SavedViewResponse description: Response for a single saved view. ProblemDetails: type: object required: - title - status - detail properties: type: type: string default: about:blank description: >- URI identifiant le type de problème; about:blank lorsque seul le statut HTTP le caractérise. title: type: string description: Titre affiché pour l'événement ou le problème. status: type: integer description: Statut HTTP de la réponse d'erreur. detail: type: string description: Informations détaillées sur le problème ou le dossier. request_id: type: string description: Identifiant de corrélation pour le diagnostic de la requête. scope: type: string description: Scope concerné par le refus d'accès, lorsqu'il est renseigné. route_id: type: string description: Identifiant de la route concernée par le problème. reason_code: type: string description: >- Code structuré du motif de refus; préférable au texte du message pour le diagnostic. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: MARKO short-lived bearer description: >- Use the `access_token` returned by `POST /v1/auth/token`. Do not send the raw API secret on business endpoints. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.