Utilisateurs

Lister les vues sauvegardées du sujet délégué

Exige un sujet utilisateur délégué résolu via header, une allowlist explicite sur la clé, et la capacité saved_views.

Scope requis : users:read. Scopes et délégation.

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é.

curl --request GET \
  --url https://partner-api.marko.fr/v1/users/me/saved-views \
  --header 'Authorization: Bearer <token>'

const url = 'https://partner-api.marko.fr/v1/users/me/saved-views';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partner-api.marko.fr/v1/users/me/saved-views', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partner-api.marko.fr/v1/users/me/saved-views",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

[
  {
    "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"
  }
]

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

Authorizations

Authorization

string

header

required

Use the access_token returned by POST /v1/auth/token. Do not send the raw API secret on business endpoints.

Headers

X-Request-ID

string

Partner-generated correlation identifier echoed in logs and error payloads.

X-Marko-Delegated-User-Id

string

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.

X-Marko-Delegated-User-Email

string

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.

Query Parameters

entity_type

string | null

Paramètre entity_type pour cette route; type, format et contraintes ci-dessous.

limit

integer

default:100

Nombre maximal de résultats sur cette page; bornes et valeur par défaut ci-dessous.

Required range: 1 <= x <= 1000

offset

integer

default:0

Nombre de résultats à ignorer avant cette page (commence à 0).

Required range: x >= 0

Response

Successful response

string<uuid>

required

Identifiant MARKO de la ressource.

user_id

string

required

Identifiant utilisateur MARKO; il n'est pas nécessairement un UUID.

entity_type

string

required

Type de ressource auquel se rapporte la vue ou le traitement.

name

string

required

Nom de la ressource. Les recherches exactes et partielles sont décrites au niveau de la route.

filters

Filters · object

required

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.

columns

string[]

required

Colonnes à afficher, dans l'ordre transmis.

sort

Sort · object

required

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.

is_default

boolean

required

Indique si cette vue ou ce template est défini par défaut.

created_at

string<date-time>

required

Date de création au format ISO 8601.

updated_at

string<date-time>

required

Date de dernière modification au format ISO 8601.

icon

string

default:bookmark

Icône d'affichage de la vue sauvegardée; respecter la liste de valeurs autorisées.

color

string

default:slate

Couleur d'affichage; respecter les valeurs ou le format indiqués dans le schéma.

⌘I

Lister les vues sauvegardées du sujet délégué

curl --request GET \
  --url https://partner-api.marko.fr/v1/users/me/saved-views \
  --header 'Authorization: Bearer <token>'

const url = 'https://partner-api.marko.fr/v1/users/me/saved-views';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partner-api.marko.fr/v1/users/me/saved-views', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partner-api.marko.fr/v1/users/me/saved-views",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

[
  {
    "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"
  }
]

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

Démarrer

Tutoriels

Intégrer

Référence API

Lister les vues sauvegardées du sujet délégué

Authorizations

Headers

Query Parameters

Response