Utilisateurs

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.

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.

Créer une vue sauvegardée pour le sujet délégué

curl --request POST \
  --url https://partner-api.marko.fr/v1/users/me/saved-views \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "entity_type": "operations",
  "name": "Vue exemple",
  "filters": {},
  "columns": [
    "name",
    "status"
  ],
  "sort": {
    "sort_by": "updated_at",
    "sort_order": "desc"
  }
}
'

import requests

url = "https://partner-api.marko.fr/v1/users/me/saved-views"

payload = {
    "entity_type": "operations",
    "name": "Vue exemple",
    "filters": {},
    "columns": ["name", "status"],
    "sort": {
        "sort_by": "updated_at",
        "sort_order": "desc"
    }
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://partner-api.marko.fr/v1/users/me/saved-views';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entity_type: 'operations',
    name: 'Vue exemple',
    filters: {},
    columns: ['name', 'status'],
    sort: {sort_by: 'updated_at', sort_order: 'desc'}
  })
};

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

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entity_type: 'operations',
    name: 'Vue exemple',
    filters: {},
    columns: ['name', 'status'],
    sort: {sort_by: 'updated_at', sort_order: 'desc'}
  })
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'entity_type' => 'operations',
    'name' => 'Vue exemple',
    'filters' => [
        
    ],
    'columns' => [
        'name',
        'status'
    ],
    'sort' => [
        'sort_by' => 'updated_at',
        'sort_order' => 'desc'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$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"
}

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

{
  "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": "Conflict",
  "status": 409,
  "detail": "The idempotency key payload, external reference, target, or source conflicts with an existing write.",
  "request_id": "req_example_partner_call"
}

{
  "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": "Precondition Required",
  "status": 428,
  "detail": "The Idempotency-Key header is required.",
  "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.

Idempotency-Key

string

required

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.

Maximum string length: 255

Pattern: ^[!-~]+$

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.

Body

application/json

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

name

string

required

Display name of the saved view

Required string length: 1 - 200

entity_type

string

required

Target entity: operations, operateurs, documents

Required string length: 1 - 50

icon

enum<string>

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

Available options:

bookmark,

briefcase,

building,

calendar,

chart,

clock,

filter,

flag,

shield,

star,

table,

target

color

enum<string>

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

Available options:

amber,

cyan,

emerald,

rose,

slate,

violet

filters

object

État de filtre; pour une vue operations, seules les clés décrites par le contrat conditionnel de création sont acceptées.

columns

string[]

Colonnes à afficher, dans l'ordre transmis.

Maximum array length: 64

Pattern: ^[a-z][a-z0-9_]{0,63}$

sort

object

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

is_default

boolean

default:false

Set as default view

Response

Successful response

Response for a single saved view.

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

Créer une vue sauvegardée pour le sujet délégué

curl --request POST \
  --url https://partner-api.marko.fr/v1/users/me/saved-views \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "entity_type": "operations",
  "name": "Vue exemple",
  "filters": {},
  "columns": [
    "name",
    "status"
  ],
  "sort": {
    "sort_by": "updated_at",
    "sort_order": "desc"
  }
}
'

import requests

url = "https://partner-api.marko.fr/v1/users/me/saved-views"

payload = {
    "entity_type": "operations",
    "name": "Vue exemple",
    "filters": {},
    "columns": ["name", "status"],
    "sort": {
        "sort_by": "updated_at",
        "sort_order": "desc"
    }
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://partner-api.marko.fr/v1/users/me/saved-views';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entity_type: 'operations',
    name: 'Vue exemple',
    filters: {},
    columns: ['name', 'status'],
    sort: {sort_by: 'updated_at', sort_order: 'desc'}
  })
};

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

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entity_type: 'operations',
    name: 'Vue exemple',
    filters: {},
    columns: ['name', 'status'],
    sort: {sort_by: 'updated_at', sort_order: 'desc'}
  })
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'entity_type' => 'operations',
    'name' => 'Vue exemple',
    'filters' => [
        
    ],
    'columns' => [
        'name',
        'status'
    ],
    'sort' => [
        'sort_by' => 'updated_at',
        'sort_order' => 'desc'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$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"
}

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

{
  "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": "Conflict",
  "status": 409,
  "detail": "The idempotency key payload, external reference, target, or source conflicts with an existing write.",
  "request_id": "req_example_partner_call"
}

{
  "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": "Precondition Required",
  "status": 428,
  "detail": "The Idempotency-Key header is required.",
  "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

Créer une vue sauvegardée pour le sujet délégué

Authorizations

Headers

Body

Response